Для AI-агентов: markdown этой страницы — /docs-content/entities/tasks/checklist/update.md индекс документации — /llms.txt

Обновить пункт чек-листа

PATCH /v1/tasks/:taskId/checklist/:itemId

Частичное обновление пункта чек-листа — передавайте только изменяемые поля. Хотя бы одно поле обязательно.

Параметры

Параметр	Тип	Обяз.	Описание
`taskId` (path)	integer	да	ID задачи
`itemId` (path)	integer	да	ID пункта чек-листа

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`title`	string	нет	Текст пункта
`sortIndex`	integer	нет	Индекс сортировки
`isComplete`	boolean / `Y`,`N`	нет	Статус выполнения
`isImportant`	boolean / `Y`,`N`	нет	Признак важности
`parentId`	integer	нет	ID родительского пункта
`members`	object	нет	Участники пункта: `{ "<userId>": { "type": "A" \| "U" } }`. Полностью заменяет текущий список — см. «Известные особенности»

Хотя бы одно из перечисленных полей обязательно — пустое тело возвращает 400.

Примеры

curl — личный ключ

Terminal

curl -X PATCH "https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Собрать и проверить документы", "isImportant": true }'

curl — OAuth-приложение

Terminal

curl -X PATCH "https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Собрать и проверить документы", "isImportant": true }'

JavaScript — личный ключ

javascript

const res = await fetch("https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213", {
  method: "PATCH",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ title: "Собрать и проверить документы", isImportant: true }),
});
const { data } = await res.json();

JavaScript — OAuth-приложение

javascript

const res = await fetch("https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213", {
  method: "PATCH",
  headers: {
    "X-Api-Key": "YOUR_APP_KEY",
    "Authorization": "Bearer USER_SESSION_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ title: "Собрать и проверить документы", isImportant: true }),
});
const { data } = await res.json();

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data.id`	number	ID обновлённого пункта

Пример ответа

JSON

{ "success": true, "data": { "id": 213 } }

Пример ответа при ошибке

400 — пустое тело запроса: