---

更新記錄詳細信息

要更新記錄的核心屬性，請使用 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
  }
}

輸入字段參考

字段	類型	描述
todoId	String	（必填）要更新的記錄的 ID
todoListId	String	如果移動記錄，則為新列表 ID
position	Float	列表中的新位置
title	String	更新的記錄標題
html/text	String	更新的描述（兩個字段必須匹配）
startedAt/duedAt	DateTime	更新的開始/結束日期，格式為 ISO 8601
color	String	可用選項中的顏色代碼

顏色選項

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

更新自定義字段

要更新自定義字段值，請使用 setTodoCustomField 變更，並使用特定字段的參數：

基於文本的字段

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

適用於： TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

數字字段

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

適用於： NUMBER, PERCENT, RATING

選擇字段

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

適用於： SELECT_SINGLE, SELECT_MULTI

專用字段

電話號碼：

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

國家：

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

位置：

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

複選框：

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

所需權限

用戶必須擁有適當的項目訪問權限才能更新記錄：

訪問級別	可以更新記錄
OWNER	✅ 是
ADMIN	✅ 是
MEMBER	✅ 是
CLIENT	✅ 是
COMMENT_ONLY	❌ 否
VIEW_ONLY	❌ 否

根據角色配置，可能還適用於 setTodoCustomField 的其他自定義字段權限。

返回值

• editTodo 返回完整的更新 Todo 對象
• setTodoCustomField 返回 Boolean! 表示成功

注意事項

1. 自定義字段 ID 可以使用 列出自定義字段 查詢找到
2. 直接使用 API 時，電話號碼必須為 E.164 格式
3. 位置字段最好通過 Blue 應用界面進行管理
4. 當提供 html 時，html 和 text 字段會自動同步
5. 所有更新操作會觸發活動日誌和 webhook 通知