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

`POST /v1/bizproc-tasks/delegate`

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

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

## Параметры

| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
| `taskIds` | integer[] | Да | Непустой массив положительных ID из [списка](./list.md) |
| `fromUserId` | integer | Да | Текущий исполнитель. Положительный ID из [пользователей](/docs/entities/users) |
| `toUserId` | integer | Да | Новый исполнитель. Положительный ID из [пользователей](/docs/entities/users) |

## Поля ответа

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

## Примеры

### cURL API key

```bash
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

```bash
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](/docs/errors).

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

- [Задания бизнес-процессов](/docs/automation/bizproc-tasks)
- [Экземпляры процессов](/docs/automation/workflows)