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

Делегировать задания

POST /v1/bizproc-tasks/delegate

Битрикс24 проверяет право делегировать задания. Метод может передать часть заданий и затем вернуть ошибку по остальным. Перечитайте список перед повтором, не считайте отказ откатом всех изменений.

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

Параметры

Поле Тип Обязательно Описание
taskIds integer[] Да Непустой массив положительных ID из списка
fromUserId integer Да Текущий исполнитель. Положительный ID из пользователей
toUserId integer Да Новый исполнитель. Положительный ID из пользователей

Поля ответа

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

Примеры

cURL API key

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/bizproc-tasks/delegate" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"taskIds":[42],"fromUserId":1,"toUserId":2}'

cURL OAuth

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/bizproc-tasks/delegate" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"taskIds":[42],"fromUserId":1,"toUserId":2}'

JavaScript API key

javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks/delegate", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"taskIds":[42],"fromUserId":1,"toUserId":2})
});
console.log(await response.json());

JavaScript OAuth

javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks/delegate", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer YOUR_SESSION_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({"taskIds":[42],"fromUserId":1,"toUserId":2})
});
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.

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