---

Aktualizacja Szczegółów Rekordu

Aby zaktualizować podstawowe właściwości rekordu, użyj mutacji 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
  }
}

Referencja Pola Wejściowego

Pole	Typ	Opis
todoId	String	(Wymagane) ID rekordu do zaktualizowania
todoListId	String	Nowe ID listy, jeśli przenosisz rekord
position	Float	Nowa pozycja na liście
title	String	Zaktualizowany tytuł rekordu
html/text	String	Zaktualizowany opis (musi być zgodny w obu polach)
startedAt/duedAt	DateTime	Zaktualizowane daty rozpoczęcia/zakończenia w formacie ISO 8601
color	String	Kod koloru z dostępnych opcji

Opcje Kolorów

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

Aktualizacja Pola Niestandardowego

Aby zaktualizować wartości pól niestandardowych, użyj mutacji setTodoCustomField z parametrami specyficznymi dla pól:

Pola Tekstowe

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

Dotyczy: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Pola Liczbowe

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

Dotyczy: NUMBER, PERCENT, RATING

Pola Wybór

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

Dotyczy: SELECT_SINGLE, SELECT_MULTI

Pola Specjalistyczne

Numery Telefonów:

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

Kraje:

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

Lokalizacja:

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

Wymagane Uprawnienia

Użytkownicy muszą mieć odpowiedni dostęp do projektu, aby aktualizować rekordy:

Poziom Dostępu	Może Aktualizować Rekordy
OWNER	✅ Tak
ADMIN	✅ Tak
MEMBER	✅ Tak
CLIENT	✅ Tak
COMMENT_ONLY	❌ Nie
VIEW_ONLY	❌ Nie

Dodatkowe uprawnienia do pól niestandardowych mogą mieć zastosowanie dla setTodoCustomField w zależności od konfiguracji roli.

Wartości Zwracane

• editTodo zwraca kompletny zaktualizowany obiekt Todo
• setTodoCustomField zwraca Boolean! wskazujący na sukces

Uwagi

1. Identyfikatory pól niestandardowych można znaleźć za pomocą zapytania lista pól niestandardowych
2. Numery telefonów muszą być w formacie E.164 podczas korzystania z API bezpośrednio
3. Pola lokalizacji najlepiej zarządzać przez interfejs aplikacji Blue
4. Pola html i text są automatycznie synchronizowane, gdy html jest podane
5. Wszystkie operacje aktualizacji wywołują logowanie aktywności i powiadomienia webhook