---

Datensatzdetails aktualisieren

Um die Kernattribute eines Datensatzes zu aktualisieren, verwenden Sie die editTodo Mutation:

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
  }
}

Eingabefeldreferenz

Feld	Typ	Beschreibung
todoId	String	(Erforderlich) Die ID des zu aktualisierenden Datensatzes
todoListId	String	Neue Listen-ID, falls der Datensatz verschoben wird
position	Float	Neue Position in der Liste
title	String	Aktualisierter Titel des Datensatzes
html/text	String	Aktualisierte Beschreibung (muss in beiden Feldern übereinstimmen)
startedAt/duedAt	DateTime	Aktualisierte Start-/Enddaten im ISO 8601-Format
color	String	Farbcode aus den verfügbaren Optionen

Farboptionen

// 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"]

Benutzerdefinierte Felder aktualisieren

Um die Werte benutzerdefinierter Felder zu aktualisieren, verwenden Sie die setTodoCustomField Mutation mit feldspezifischen Parametern:

Textbasierte Felder

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

Gilt für: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Numerische Felder

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

Gilt für: NUMBER, PERCENT, RATING

Auswahlfelder

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

Gilt für: SELECT_SINGLE, SELECT_MULTI

Spezialisierte Felder

Telefonnummern:

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

Länder:

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

Standort:

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
    }
  )
}

Erforderliche Berechtigungen

Benutzer müssen über die entsprechenden Projektzugriffe verfügen, um Datensätze zu aktualisieren:

Zugriffslevel	Kann Datensätze aktualisieren
OWNER	✅ Ja
ADMIN	✅ Ja
MEMBER	✅ Ja
CLIENT	✅ Ja
COMMENT_ONLY	❌ Nein
VIEW_ONLY	❌ Nein

Zusätzliche Berechtigungen für benutzerdefinierte Felder können für setTodoCustomField basierend auf der Rollenkonfiguration gelten.

Rückgabewerte

• editTodo gibt das vollständige aktualisierte Todo Objekt zurück
• setTodoCustomField gibt Boolean! zurück, das den Erfolg anzeigt

Hinweise

1. Die IDs benutzerdefinierter Felder können mit der Liste benutzerdefinierter Felder Abfrage gefunden werden.
2. Telefonnummern müssen im E.164-Format vorliegen, wenn die API direkt verwendet wird.
3. Standortfelder werden am besten über die Benutzeroberfläche der Blue-App verwaltet.
4. Die html und text Felder werden automatisch synchronisiert, wenn html bereitgestellt wird.
5. Alle Aktualisierungsoperationen lösen eine Aktivitätsprotokollierung und Webhook-Benachrichtigungen aus.