Обновить задачу

PATCH /v1/tasks/:id

Обновляет поля существующей задачи. Передавайте только изменяемые поля. Полный список — Поля задачи.

Параметры

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

Передавайте только изменяемые поля — поведение PATCH, остальные значения не затрагиваются.

Поля id, dateStart, activityDate, realStatus — read-only, в body не передаются.

Служебные поля задачи можно задавать

createdBy (постановщик), changedBy, closedBy, statusChangedBy, createdDate, changedDate, closedDate принимаются и при создании, и при обновлении: Битрикс24 сохраняет переданные значения, а Вайбкод — обёртка над ним и не запрещает того, что разрешает платформа. Принимаются оба написания — и createdBy, и CREATED_BY. Передавайте одно из двух, а не оба сразу: при обоих в одном теле применится то, которое встретится позже, без предупреждения.

Значение применяется в пределах прав вызывающего пользователя. Если Битрикс24 отказывает в правке задачи, отказ приходит как есть — 422 с его собственным текстом, без подмены на нашу ошибку и без ложного успеха.

Что видно в журнале задачи. Смену постановщика Битрикс24 пишет в журнал изменений задачи, и там остаётся настоящий вызывающий пользователь, а не тот, кого передали в createdBy. Для остальных шести полей отдельной записи в журнале не предусмотрено: по значению в карточке нельзя определить, кто его выставил.

Дата без часового пояса. У createdDate, changedDate и closedDate значение вида 2019-05-15T13:47:00 в написании createdDate получает смещение вашего пояса из заголовка X-Vibe-Timezone, а в написании CREATED_DATE уходит как есть и читается в поясе владельца ключа. Передавайте дату со смещением — 2019-05-15T13:47:00+03:00 — и оба написания дадут один и тот же момент.

Ограничить подмену служебных полей может только модель прав Битрикс24 — это отдельная доработка на стороне платформы, а не нашей обёртки.

Передавайте только существующего сотрудника. Битрикс24 не проверяет идентификатор пользователя на существование ни в createdBy, ни в changedBy, closedBy, statusChangedBy — он запишет любое число. Задача с несуществующим постановщиком перестаёт управляться через API: Битрикс24 отказывает и в дальнейшем обновлении, и в удалении (Действие над задачей не разрешено), причём и через обёртку, и напрямую, даже ключу администратора. Такой исход проверен на createdBy. У трёх остальных полей идентификатор не проверяется так же, поэтому передавайте существующего сотрудника и в них. Список сотрудников: GET /v1/users.

Часто обновляемые поля

Примеры

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

curl -X PATCH "https://vibecode.bitrix24.tech/v1/tasks/3871" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": 5,
    "priority": 2
  }'

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

curl -X PATCH "https://vibecode.bitrix24.tech/v1/tasks/3871" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": 5,
    "priority": 2
  }'

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/3871', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    status: 5,
    priority: 2,
  }),
})

const { success, data } = await res.json()

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/3871', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    status: 5,
    priority: 2,
  }),
})

const { success, data } = await res.json()

Поля ответа

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

{
  "success": true,
  "data": {
    "id": 3871,
    "title": "Подготовить отчёт за квартал",
    "status": 5,
    "priority": 2,
    "responsibleId": 1,
    "createdBy": 1,
    "createdDate": "2026-05-12T08:46:12.000Z",
    "changedDate": "2026-05-12T10:02:48.000Z",
    "closedDate": "2026-05-12T10:02:48.000Z",
    "deadline": "2026-05-19T15:00:00.000Z",
    "accomplices": [],
    "auditors": []
  }
}

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

400 — попытка изменить поле, доступное только на чтение:

{
  "success": false,
  "error": {
    "code": "READONLY_FIELD",
    "message": "Field 'activityDate' is read-only and cannot be set"
  }
}

Ошибки

Полный список общих ошибок API — Ошибки.

Известные особенности

Закрытие задачи. Чтобы пометить задачу выполненной, отправьте status: 5. После этого Битрикс24 сам заполняет closedDate — при переводе в статус 5 (завершена) или 6 (отложена). Передавать closedDate вручную тоже можно — см. раздел о служебных полях выше. Если поле не передано, платформа проставит его сама.

Смотрите также

• Получить задачу
• Поля задачи
• Удалить задачу
• Список задач
• Загрузить файл
• Batch
• Лимиты и оптимизация