метод REST scope: humanresources

humanresources.node.member.set

Обновить состав участников отдела

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

Описание

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

Метод humanresources.node.member.set обновляет состав участников отдела или команды по ролям.

Параметры

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

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

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

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

Объект со списками идентификаторов пользователей в формате {"Роль_пользователя": [Идентификатор_пользователя]}. Описание структуры объекта

Метод добавляет новых участников, обновляет роли существующих и удаляет из отдела пользователей, которых нет во входном объекте userIds.

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

Параметр userIds

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

Идентификаторы руководителей отдела

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

Идентификаторы заместителей руководителя отдела

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

Идентификаторы сотрудников отдела

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

Идентификаторы руководителей команды

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

Идентификаторы заместителей руководителя команды

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

Идентификаторы участников команды

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

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

Ответ

HTTP-статус: 200

{
    "result": {
        "success": true
    },
    "time": {
        "start": 1780405900,
        "finish": 1780405900.242662,
        "duration": 0.2426619529724121,
        "processing": 0.19870305061340332,
        "date_start": "2026-06-02T16:11:40+03:00",
        "date_finish": "2026-06-02T16:11:40+03:00",
        "operating_reset_at": 1780406500,
        "operating": 0
    }
}

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

result object

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

success boolean

Значение true, если состав участников успешно обновлен

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Invalid roles: MEMBER_OWNER. Allowed: MEMBER_HEAD, MEMBER_DEPUTY_HEAD, MEMBER_EMPLOYEE.",
                "field": "userIds"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
nodeId Parameter "nodeId" is required. Передайте идентификатор отдела или команды
userIds Parameter "userIds" is required and must be a non-empty array. Передайте объект с непустыми списками пользователей по ролям
userIds Invalid roles: #ROLE#. Allowed: #ROLE_LIST#. Передайте только роли, которые поддерживаются для выбранного типа отдела или команды

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

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