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

Завершить задание

POST /v1/bizproc-tasks/:id/complete

Это реальное согласование, а не проба. approve, reject, ok, cancel передаются как 1, 2, 3, 4. Допустимые решения зависят от типа задания и проверяются Битрикс24. После таймаута перечитайте список: повтор может получить отказ «задание уже выполнено».

Bitrix24 API: bizproc.task.complete Скоуп: bizproc

Параметры

Поле Тип Обязательно Описание
id integer Да Положительный ID задания из списка
status string Да approve / reject / ok / cancel
comment string Нет Комментарий к решению. Обязателен, если этого требует форма задания
fields object Нет Значения по коду поля из parameters.Fields[].Id. Файл — [имя, base64]. Лимит тела запроса — 1 МиБ

Поля ответа

Поле Тип Описание
success boolean true
data boolean true, только если Битрикс24 вернул true

Примеры

cURL API key

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/bizproc-tasks/42/complete" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"approve","comment":"VIBE-PROBE"}'

cURL OAuth

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/bizproc-tasks/42/complete" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"approve","comment":"VIBE-PROBE"}'

JavaScript API key

javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks/42/complete", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"status":"approve","comment":"VIBE-PROBE"})
});
console.log(await response.json());

JavaScript OAuth

javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks/42/complete", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer YOUR_SESSION_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({"status":"approve","comment":"VIBE-PROBE"})
});
console.log(await response.json());

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

Пример формы ответа из поведенческого теста. Живое согласование не выполнялось.

JSON
{"success":true,"data":true}

Неверные параметры отклоняются до вызова Битрикс24:

JSON
{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid request parameters"}}

Ошибки

HTTP Code Условие
400 INVALID_PARAMS Неверные или отсутствующие параметры
401 TOKEN_MISSING Нет реквизитов авторизации Битрикс24
403 SCOPE_DENIED Нет скоупа bizproc
403 BITRIX_ACCESS_DENIED Битрикс24 отказал в доступе
403 WRITE_BLOCKED_READONLY_KEY Ключ запрещает запись
404 ENTITY_NOT_FOUND Задание текущего пользователя не найдено
422 BITRIX_ERROR Бизнес-отказ Битрикс24. Текст сохранён с удалением секретов
502 BITRIX_RESPONSE_INVALID Неожиданная форма ответа или результат действия

Общие отказы и лимиты: Ошибки API.

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