# bizproc.task.delegate

URL: https://chugunov.pro/api-bitrix24/bizproc/bizproc-task/bizproc-task-delegate/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Делегировать задание бизнес-процесса
Scope: `bizproc`
Кто может выполнять метод: любой пользователь, ответственный за задание бизнес-процесса

## Описание

Метод делегирует задание бизнес-процесса. Делегировать можно только свое задание.

**Пользовательская документация**

- [Действия: Задания](https://helpdesk.bitrix24.ru/open/7451037/)

## Параметры

- `TASK_IDS` `array` — обязательный. Список идентификаторов заданий.
  Получить идентификаторы можно методом [bizproc.task.list](https://chugunov.pro/api-bitrix24/bizproc/bizproc-task/bizproc-task-list/)
- `FROM_USER_ID` `integer` — обязательный. Идентификатор пользователя, от которого задания будут делегированы.
  Получить идентификатор пользователя можно методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/)
- `TO_USER_ID` `integer` — обязательный. Идентификатор пользователя, которому задания будут делегированы.
  Получить идентификатор пользователя можно методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/).
  Кому можно делегировать, зависит от настроек задания: только подчиненным, всем сотрудникам или никому.

## Ответ

HTTP-статус: 200

```json
{
    "result": true,
    "time": {
        "start": 1748526089.625516,
        "finish": 1748526089.656787,
        "duration": 0.03127098083496094,
        "processing": 0.008746147155761719,
        "date_start": "2025-05-29T16:41:29+03:00",
        "date_finish": "2025-05-29T16:41:29+03:00",
        "operating_reset_at": 1748526689,
        "operating": 0
    }
}
```

### Возвращаемые данные

- `result` `boolean`. Возвращает `true`, если задание делегировано успешно
- `time` `time`. Информация о времени выполнения запроса

## Ошибки

HTTP-статус: 400

```json
{
    "error": "ERROR_INVALID_USER_ID",
    "error_description": "Invalid FROM_USER_ID"
}
```

- `ERROR_TASK_VALIDATION` — Invalid TASK_IDS. Некорректные идентификаторы заданий или не передан параметр `TASK_IDS`
- `ERROR_INVALID_USER_ID` — Invalid FROM_USER_ID. Некорректный или отсутствующий идентификатор пользователя, от которого идет делегирование
- `ERROR_INVALID_USER_ID` — Invalid TO_USER_ID. Некорректный или отсутствующий идентификатор пользователя, которому идет делегирование
- `ERROR_DELEGATION_NOT_ALLOWED` — Пользователь не является ответственным за задание. Пользователь, указанный в параметре `FROM_USER_ID` не является ответственным за задание
- `ERROR_DELEGATION_NOT_ALLOWED` — Делегирование заданий доступно только для интранет-пользователей. Пользователь, указанный в параметре `TO_USER_ID`, не является интранет-пользователем
- `ERROR_DELEGATION_NOT_ALLOWED` — Перечисление ошибок через символ `;`. В методе можно передать несколько заданий. Если возникнут ошибки в нескольких заданиях, они вернутся перечислением через символ `;`

## Примеры запроса

### cURL (Webhook)

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASK_IDS":[1128,1129,1130],"FROM_USER_ID":15,"TO_USER_ID":37}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/bizproc.task.delegate
```

### cURL (OAuth)

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASK_IDS":[1128,1129,1130],"FROM_USER_ID":15,"TO_USER_ID":37,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/bizproc.task.delegate
```

### JS

```javascript
try
{
    const response = await $b24.callMethod(
        'bizproc.task.delegate',
        {
            TASK_IDS: [1128, 1129, 1130],
            FROM_USER_ID: 15,
            TO_USER_ID: 37,
        }
    );
    
    const result = response.getData().result;
    console.log('Delegated tasks:', result);
    
}
catch( error )
{
    console.error('Error:', error);
}
```

### Python

```python
from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.bizproc.task.delegate(
        task_ids=[
            1128,
            1129,
            1130,
        ],
        from_user_id=15,
        to_user_id=37,
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")
```

### PHP

```php
try {
    $response = $b24Service
        ->core
        ->call(
            'bizproc.task.delegate',
            [
                'TASK_IDS' => [1128, 1129, 1130],
                'FROM_USER_ID' => 15,
                'TO_USER_ID' => 37,
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
    error_log($e->getMessage());
    echo 'Error delegating task: ' . $e->getMessage();
}
```

### BX24.js

```js
BX24.callMethod(
    'bizproc.task.delegate',
    {
        'TASK_IDS': [1128, 1129, 1130],
        'FROM_USER_ID': 15,
        'TO_USER_ID': 37,
    },
    function(result)
    {
        if(result.error())
            alert("Error: " + result.error());
        else
            console.log(result.data());
    }
);
```

### PHP CRest

```php
require_once('crest.php');

$result = CRest::call(
    'bizproc.task.delegate',
    [
        'TASK_IDS' => [1128, 1129, 1130],
        'FROM_USER_ID' => 15,
        'TO_USER_ID' => 37
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';
```

### Go

```go
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "bizproc.task.delegate", b24.Params{
	"TASK_IDS":     []int{1128, 1129, 1130},
	"FROM_USER_ID": 15,
	"TO_USER_ID":   37,
})
if err != nil {
	return fmt.Errorf("bizproc.task.delegate: %w", err)
}

var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
```

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/bizproc/bizproc-task/bizproc-task-delegate.html
