Узнайте, как обновить детали записи и пользовательские поля с помощью API Blue.
Обновить детали записи
Чтобы обновить основные свойства записи, используйте мутацию 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!
, указывая на успех
Примечания
- ID пользовательских полей можно найти с помощью запроса список пользовательских полей
- Телефонные номера должны быть в формате E.164 при использовании API напрямую
- Поля местоположения лучше всего управляются через интерфейс приложения Blue
- Поля
html
иtext
автоматически синхронизируются, когда предоставляетсяhtml
- Все операции обновления вызывают ведение журнала активности и уведомления вебхуков