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

Обновить дело

PATCH /v1/activities/:id

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

Тип дела typeId задаётся только при создании — запрос с ним отвечает 400 READONLY_FIELD. Чтобы получить дело другого типа, создайте новое через POST /v1/activities и удалите прежнее.

Срок deadline в теле не передаётся — запрос с ним отвечает 400 READONLY_FIELD. Срок дела меняет POST /v1/activities/:id/deadline, а сдвиг на заданное время — POST /v1/activities/:id/postpone.

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типnumber Обяз.да ОписаниеID дела. Список: GET /v1/activities

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

Все поля тела необязательны.

Поле Тип Описание
Полеcompleted Типboolean ОписаниеОтметить завершённым
Полеsubject Типstring ОписаниеТема
ПолеresponsibleId Типnumber ОписаниеОтветственный. Список: GET /v1/users
Полеpriority Типnumber ОписаниеПриоритет: 1 — низкий, 2 — средний, 3 — высокий
Полеdescription Типstring ОписаниеОписание

Примеры

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/activities/3894" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "completed": true,
    "subject": "Встреча по проекту (завершена)"
  }'

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/activities/3894" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "completed": true,
    "subject": "Встреча по проекту (завершена)"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities/3894', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    completed: true,
    subject: 'Встреча по проекту (завершена)',
  }),
})

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

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities/3894', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    completed: true,
    subject: 'Встреча по проекту (завершена)',
  }),
})

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

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata Типobject ОписаниеОбновлённый объект дела со всеми полями — см. Поля дела

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

Показаны основные поля. Полный список: Поля дела.

JSON 
{
  "success": true,
  "data": {
    "id": 3894,
    "typeId": 1,
    "ownerTypeId": 3,
    "ownerId": 17,
    "subject": "Встреча по проекту (завершена)",
    "completed": true,
    "status": 2,
    "responsibleId": 1,
    "startTime": "2026-10-21T07:00:00.000Z",
    "endTime": "2026-10-21T08:00:00.000Z",
    "updatedAt": "2026-10-19T13:36:49.000Z"
  }
}

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

404 — дело не найдено:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Activity is not found."
  }
}

Ошибки

HTTP Код Описание
HTTP404 КодENTITY_NOT_FOUND ОписаниеДело не найдено
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеУ пользователя ключа нет прав на это дело в Битрикс24
HTTP400 КодREADONLY_FIELD ОписаниеВ теле передано поле, которое нельзя менять этим запросом: typeId задаётся только при создании, срок deadline меняет POST /v1/activities/:id/deadline, а id, authorId, editorId, associatedEntityId — поля только для чтения
HTTP400 КодINVALID_PARAMS ОписаниеЗначение поля не соответствует объявленному типу — например, строка вместо числа в priority
HTTP400 КодINVALID_PARAMS Описаниеid не целое неотрицательное число. Сообщение: id must be a non-negative integer
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч только для чтения — см. права доступа
HTTP403 КодSCOPE_DENIED ОписаниеAPI-ключ не имеет скоупа crm
HTTP401 КодTOKEN_MISSING ОписаниеAPI-ключ не имеет настроенных токенов

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

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