метод REST scope: humanresources

humanresources.node.member.remove

Удалить участников из отдела

Кто может выполнять: пользователь с правом «Удаление сотрудников из отдела» или «Удаление участников из команды»

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод humanresources.node.member.remove удаляет пользователей из указанного отдела или команды.

Параметры

nodeId integer обязательный

Идентификатор отдела или команды.

Идентификатор можно получить методом humanresources.node.list

userIds array обязательный

Массив идентификаторов пользователей, которых нужно удалить.

Идентификаторы пользователей можно получить методом user.get

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"nodeId":15,"userIds":[18,25,31]}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.member.remove

Ответ

HTTP-статус: 200

{
    "result": {
        "removed": [
            18,
            25
        ],
        "failed": [
            {
                "userId": 31,
                "reason": "Not found in this node"
            }
        ]
    },
    "time": {
        "start": 1780406400,
        "finish": 1780406400.207548,
        "duration": 0.2075481414794922,
        "processing": 0.16550898551940918,
        "date_start": "2026-06-02T16:20:00+03:00",
        "date_finish": "2026-06-02T16:20:00+03:00",
        "operating_reset_at": 1780407000,
        "operating": 0
    }
}

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

result object

Объект с результатом операции

removed array

Массив идентификаторов пользователей, которые успешно удалены

failed array

Массив пользователей, которых не удалось удалить

failed[] object

Объект с описанием ошибки удаления

userId integer

Идентификатор пользователя, которого не удалось удалить

reason string

Причина, по которой пользователь не был удален

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Parameter \"userIds\" is required and must be a non-empty array.",
                "field": "userIds"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
nodeId Parameter "nodeId" is required. Передайте идентификатор отдела или команды
userIds Parameter "userIds" is required and must be a non-empty array. Передайте непустой массив идентификаторов пользователей

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.