---

Aggiorna Dettagli del Record

Per aggiornare le proprietà fondamentali di un record, utilizza la mutazione editTodo:

mutation UpdateRecordDetails {
  editTodo(
    input: {
      todoId: "YOUR RECORD ID"
      todoListId: "RECORD LIST ID TO MOVE THE RECORD TO"
      position: "NEW RECORD POSITION IN NUMBER"
      title: "NEW RECORD TITLE"
      html: "NEW RECORD DESCRIPTION IN HTML (MUST MATCH TEXT)"
      text: "NEW RECORD DESCRIPTION IN TEXT (MUST MATCH HTML)"
      startedAt: "NEW RECORD DUE DATE (START)"
      duedAt: "NEW RECORD DUE DATE (END)"
      color: "RECORD COLOR CODE"
    }
  ) {
    id
    title
    position
    html
    text
    color
  }
}

Riferimento ai Campi di Input

Campo	Tipo	Descrizione
todoId	String	(Obbligatorio) L'ID del record da aggiornare
todoListId	String	Nuovo ID della lista se si sposta il record
position	Float	Nuova posizione nella lista
title	String	Titolo del record aggiornato
html/text	String	Descrizione aggiornata (deve corrispondere in entrambi i campi)
startedAt/duedAt	DateTime	Date di inizio/fine aggiornate in formato ISO 8601
color	String	Codice colore dalle opzioni disponibili

Opzioni di Colore

// Light theme colors
["#ffc2d4", "#ed8285", "#ffb55e", "#ffe885", "#ccf07d", 
 "#91e38c", "#a1f7fa", "#91cfff", "#c29ee0", "#e8bd91"]

// Dark theme colors  
["#ff8ebe", "#ff4b4b", "#ff9e4b", "#ffdc6b", "#b4e051",
 "#66d37e", "#4fd2ff", "#4a9fff", "#a17ee8", "#e89e64"]

Aggiorna Campi Personalizzati

Per aggiornare i valori dei campi personalizzati, utilizza la mutazione setTodoCustomField con parametri specifici per campo:

Campi Basati su Testo

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      text: "VALUE"
    }
  )
}

Si applica a: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Campi Numerici

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID" 
      number: "NUMERIC_VALUE"
    }
  )
}

Si applica a: NUMBER, PERCENT, RATING

Campi di Selezione

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      customFieldOptionIds: ["OPTION_ID_1", "OPTION_ID_2"]
    }
  )
}

Si applica a: SELECT_SINGLE, SELECT_MULTI

Campi Specializzati

Numeri di Telefono:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      text: "+33642526644"
      regionCode: "FR"
    }
  )
}

Paesi:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      countryCodes: ["AF", "AL", "DZ"]
      text: "Afghanistan, Albania, Algeria"
    }
  )
}

Posizione:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      latitude: 42.2923323
      longitude: 12.126621199999999
      text: "Via Cassia, Querce d'Orlando, Capranica, Italy"
    }
  )
}

Checkbox:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      checked: true
    }
  )
}

Permessi Richiesti

Gli utenti devono avere accesso appropriato al progetto per aggiornare i record:

Livello di Accesso	Può Aggiornare Record
OWNER	✅ Sì
ADMIN	✅ Sì
MEMBER	✅ Sì
CLIENT	✅ Sì
COMMENT_ONLY	❌ No
VIEW_ONLY	❌ No

Possono applicarsi ulteriori permessi per i campi personalizzati per setTodoCustomField in base alla configurazione del ruolo.

Valori di Ritorno

• editTodo restituisce l'oggetto Todo aggiornato completo
• setTodoCustomField restituisce Boolean! che indica il successo

Note

1. Gli ID dei campi personalizzati possono essere trovati utilizzando la query elenca campi personalizzati
2. I numeri di telefono devono essere in formato E.164 quando si utilizza direttamente l'API
3. I campi di posizione sono meglio gestiti tramite l'interfaccia dell'app di Blue
4. I campi html e text vengono sincronizzati automaticamente quando viene fornito html
5. Tutte le operazioni di aggiornamento attivano la registrazione delle attività e le notifiche webhook