Узнайте, как обновить детали записи и пользовательские поля с помощью 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!, указывая на успех

Примечания

  1. ID пользовательских полей можно найти с помощью запроса список пользовательских полей
  2. Телефонные номера должны быть в формате E.164 при использовании API напрямую
  3. Поля местоположения лучше всего управляются через интерфейс приложения Blue
  4. Поля html и text автоматически синхронизируются, когда предоставляется html
  5. Все операции обновления вызывают ведение журнала активности и уведомления вебхуков

AI Ассистент

Ответы генерируются с использованием ИИ и могут содержать ошибки.

Как я могу вам помочь?

Спросите меня о чем угодно, связанном с Blue или этой документацией.

Введите для отправки • Shift+Enter для новой строки • ⌘I для открытия