метод REST scope: humanresources

humanresources.node.edit

Обновить отдел

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

Описание

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

Метод humanresources.node.edit обновляет свойства отдела или команды.

Параметры

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

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

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

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

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

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

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

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

Новый цвет команды.

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

  • blue — синий
  • green — зеленый
  • cyan — голубой
  • orange — оранжевый
  • purple — фиолетовый
  • pink — розовый

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":44,"name":"Отдел продаж B2B","description":"Работает с корпоративными клиентами"}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.edit

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 44,
        "name": "Отдел продаж B2B",
        "type": "DEPARTMENT",
        "structureId": 1,
        "parentId": 1,
        "description": "Работает с корпоративными клиентами",
        "accessCode": "DR44",
        "userCount": 18,
        "colorName": null,
        "xmlId": null,
        "createdAt": "2026-05-30T09:20:15+03:00",
        "updatedAt": "2026-06-02T12:40:18+03:00"
    },
    "time": {
        "start": 1780393218,
        "finish": 1780393218.504217,
        "duration": 0.5042169094085693,
        "processing": 0.47100210189819336,
        "date_start": "2026-06-02T12:40:18+03:00",
        "date_finish": "2026-06-02T12:40:18+03:00",
        "operating_reset_at": 1780393818,
        "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": "At least one of the following fields must be provided: name, description, colorName.",
                "field": "name"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id Обязательное поле id не указано Добавьте id в тело запроса
id В поле id требуется тип данных int для такого запроса Убедитесь, что значение id передано числом
name description colorName Нужно передать хотя бы одно поле для изменения Передайте name, description или colorName
colorName Передано недопустимое значение цвета Используйте одно из допустимых значений из описания параметра colorName

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

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