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

Отложить дело

POST /v1/activities/:id/postpone

Сдвигает начало, окончание и крайний срок дела CRM вперёд на заданное число секунд. Вызывайте, когда дело нужно перенести на более позднее время без расчёта новой даты.

Параметры

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

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

Поле Тип Обяз. Описание
Полеoffset Типinteger Обяз.да ОписаниеСдвиг в секундах, целое число больше нуля: 3600 — на час, 86400 — на сутки. Число строкой, например "3600", отклоняется. Сдвинуть дело на более раннее время — Перенести срок дела

Других полей тело не принимает.

Примеры

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/activities/3894/postpone" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset": 3600}'

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/activities/3894/postpone" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"offset": 3600}'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities/3894/postpone', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ offset: 3600 }),
})

const { success, data } = await res.json()
console.log('Новый срок:', data.deadline)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities/3894/postpone', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ offset: 3600 }),
})

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

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue при успешном запросе
Полеdata Типobject ОписаниеДело, перечитанное после переноса. Все поля — Поля дела
Полеdata.startTime Типdatetime ОписаниеНачало дела после сдвига
Полеdata.endTime Типdatetime ОписаниеОкончание дела после сдвига
Полеdata.deadline Типdatetime ОписаниеКрайний срок после сдвига

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

Дело со сроком 2026-10-22T12:00:00.000Z отложено на час. Показаны основные поля. Полный список: Поля дела.

JSON 
{
  "success": true,
  "data": {
    "id": 3894,
    "ownerTypeId": 3,
    "ownerId": 17,
    "subject": "Звонок клиенту",
    "completed": false,
    "status": 1,
    "startTime": "2026-10-22T13:00:00.000Z",
    "endTime": "2026-10-22T13:15:00.000Z",
    "deadline": "2026-10-22T13:00:00.000Z",
    "updatedAt": "2026-10-19T11:47:47.000Z"
  }
}

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

400 — offset не положительное целое число:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "offset must be a positive integer in seconds"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS Описаниеoffset не передан, равен нулю, отрицательный, дробный или передан строкой. Сообщение: offset must be a positive integer in seconds
HTTP400 КодINVALID_PARAMS ОписаниеВ теле кроме offset передано другое поле. Сообщение: Unsupported action field
HTTP400 КодINVALID_PARAMS Описаниеid не целое положительное число. Сообщение: id must be a positive integer
HTTP404 КодENTITY_NOT_FOUND ОписаниеДела с таким id нет
HTTP422 КодACTIVITY_POSTPONE_NOT_APPLIED ОписаниеБитрикс24 подтвердил перенос, но начало, окончание и срок дела не изменились. Для дела-задачи эта проверка не выполняется
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 отказался перенести дело. Текст отказа — в message
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеУ пользователя ключа нет прав на это дело в Битрикс24
HTTP502 КодBITRIX_ERROR ОписаниеУ дела нет корректной привязки к сущности CRM. Сообщение: Activity has no valid CRM owner
HTTP502 КодBITRIX_ERROR ОписаниеПеренос отправлен, но дело не удалось перечитать. Сообщение: Activity could not be read back. Проверьте состояние дела через GET /v1/activities/:id
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч только для чтения — см. права доступа
HTTP403 КодSCOPE_DENIED ОписаниеAPI-ключ не имеет скоупа crm
HTTP401 КодTOKEN_MISSING ОписаниеAPI-ключ не имеет настроенных токенов

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

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

Завершённое дело тоже переносится. Вызов на завершённом деле отвечает 200: начало, окончание и срок сдвигаются, completed остаётся true.

У дела-задачи переносится срок задачи. Для дела с providerId равным TASKS, а также для дела с typeId равным 3 сдвигается срок связанной задачи. Время самого дела в data при этом может остаться прежним. Новый срок читайте в самой задаче — GET /v1/tasks/:id.

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