метод REST scope: humanresources

humanresources.node.member.move

Перенести участников в отдел

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

Описание

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

Метод humanresources.node.member.move переносит пользователей в указанный отдел или команду.

Параметры

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

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

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

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

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

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

role string необязательный

Роль, которую нужно назначить перенесенным участникам.

Возможные значения для отдела:

  • MEMBER_HEAD — руководитель отдела
  • MEMBER_DEPUTY_HEAD — заместитель руководителя отдела
  • MEMBER_EMPLOYEE — сотрудник отдела

Возможные значения для команды:

  • MEMBER_TEAM_HEAD — руководитель команды
  • MEMBER_TEAM_DEPUTY_HEAD — заместитель руководителя команды
  • MEMBER_TEAM_EMPLOYEE — участник команды

По умолчанию: MEMBER_EMPLOYEE для отдела и MEMBER_TEAM_EMPLOYEE для команды

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"nodeId":28,"userIds":[12,18],"role":"MEMBER_EMPLOYEE"}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.member.move

Ответ

HTTP-статус: 200

{
    "result": {
        "success": true
    },
    "time": {
        "start": 1780406100,
        "finish": 1780406100.215497,
        "duration": 0.21549701690673828,
        "processing": 0.1711289882659912,
        "date_start": "2026-06-02T16:15:00+03:00",
        "date_finish": "2026-06-02T16:15:00+03:00",
        "operating_reset_at": 1780406700,
        "operating": 0
    }
}

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

result object

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

success boolean

Значение true, если пользователи успешно перенесены

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION",
        "message": "Запись с ID = `28` не найдена"
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
nodeId Parameter "nodeId" is required. Передайте идентификатор отдела или команды
userIds Parameter "userIds" is required and must be a non-empty array. Передайте непустой массив идентификаторов пользователей
role Invalid role #ROLE#. Allowed: #ROLE_LIST#. Передайте роль, которая поддерживается для выбранного типа отдела или команды

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

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