---

Memperbarui Detail Rekaman

Untuk memperbarui properti inti dari sebuah rekaman, gunakan mutasi 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
  }
}

Referensi Bidang Input

Bidang	Tipe	Deskripsi
todoId	String	(Diperlukan) ID dari rekaman yang akan diperbarui
todoListId	String	ID daftar baru jika memindahkan rekaman
position	Float	Posisi baru dalam daftar
title	String	Judul rekaman yang diperbarui
html/text	String	Deskripsi yang diperbarui (harus cocok di kedua bidang)
startedAt/duedAt	DateTime	Tanggal mulai/akhir yang diperbarui dalam format ISO 8601
color	String	Kode warna dari opsi yang tersedia

Opsi Warna

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

Memperbarui Bidang Kustom

Untuk memperbarui nilai bidang kustom, gunakan mutasi setTodoCustomField dengan parameter spesifik bidang:

Bidang Berbasis Teks

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

Berlaku untuk: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Bidang Numerik

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

Berlaku untuk: NUMBER, PERCENT, RATING

Bidang Pilihan

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

Berlaku untuk: SELECT_SINGLE, SELECT_MULTI

Bidang Khusus

Nomor Telepon:

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

Negara:

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

Lokasi:

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

Kotak Centang:

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

Izin yang Diperlukan

Pengguna harus memiliki akses proyek yang sesuai untuk memperbarui rekaman:

Tingkat Akses	Dapat Memperbarui Rekaman
OWNER	✅ Ya
ADMIN	✅ Ya
MEMBER	✅ Ya
CLIENT	✅ Ya
COMMENT_ONLY	❌ Tidak
VIEW_ONLY	❌ Tidak

Izin bidang kustom tambahan mungkin berlaku untuk setTodoCustomField berdasarkan konfigurasi peran.

Nilai Kembali

• editTodo mengembalikan objek Todo yang diperbarui secara lengkap
• setTodoCustomField mengembalikan Boolean! yang menunjukkan keberhasilan

Catatan

1. ID bidang kustom dapat ditemukan menggunakan kueri daftar bidang kustom
2. Nomor telepon harus dalam format E.164 saat menggunakan API secara langsung
3. Bidang lokasi sebaiknya dikelola melalui antarmuka aplikasi Blue
4. Bidang html dan text disinkronkan secara otomatis ketika html disediakan
5. Semua operasi pembaruan memicu pencatatan aktivitas dan pemberitahuan webhook