Для 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
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
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
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
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());
Пример ответа
Пример формы ответа из поведенческого теста. Живое согласование не выполнялось.
{"success":true,"data":true}
Неверные параметры отклоняются до вызова Битрикс24:
{"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.