метод REST scope: humanresources

humanresources.node.move

Переместить отдел

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

Описание

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

Метод humanresources.node.move меняет родительский отдел для отдела или команды.

Параметры

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

Идентификатор отдела или команды, который нужно переместить.

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

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

Идентификатор нового родительского отдела.

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":44,"parentId":2}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.move

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 44,
        "name": "Отдел продаж B2B",
        "type": "DEPARTMENT",
        "structureId": 1,
        "parentId": 2,
        "description": "Работа с корпоративными клиентами",
        "accessCode": "DR44",
        "userCount": 18,
        "colorName": null,
        "xmlId": null,
        "createdAt": "2026-05-30T09:20:15+03:00",
        "updatedAt": "2026-06-02T14:40:18+03:00"
    },
    "time": {
        "start": 1780400418,
        "finish": 1780400418.402915,
        "duration": 0.40291500091552734,
        "processing": 0.3614809513092041,
        "date_start": "2026-06-02T14:40:18+03:00",
        "date_finish": "2026-06-02T14:40:18+03:00",
        "operating_reset_at": 1780401018,
        "operating": 0
    }
}

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

result object

Объект с данными перемещенного отдела или команды

id integer

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

name string

Название отдела или команды

type string

Тип элемента структуры

structureId integer

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

parentId integer

Идентификатор нового родительского отдела

description string

Описание отдела или команды

accessCode string

Код доступа отдела или команды

userCount integer

Количество пользователей в отделе или команде

colorName string

Цвет команды, если он задан

xmlId string

Внешний идентификатор отдела или команды

createdAt datetime

Дата и время создания отдела или команды

updatedAt datetime

Дата и время последнего обновления отдела или команды

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Обязательное поле `parentId` не указано",
                "field": "parentId"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id parentId Обязательное поле #FIELD# не указано Добавьте указанное поле в тело запроса
FIELD# В поле #FIELD# требуется тип данных #TYPE# для такого запроса Убедитесь, что передаваемое значение нужного типа

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

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