метод REST scope: entity

entity.section.update

Обновить раздел хранилища

Кто может выполнять: пользователь с уровнем права W (запись) или X (управление) на хранилище данных

Описание

Метод entity.section.update обновляет раздел хранилища данных приложения.

Метод работает только в контексте приложения.

Параметры

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

Идентификатор хранилища данных приложения. Используйте значение, которое указали при создании хранилища.

Получить идентификатор можно методом entity.get

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

Идентификатор раздела для обновления

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

Название раздела

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

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

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

Флаг активности раздела:
- Y — раздел активен
- N — раздел неактивен

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

Индекс сортировки раздела

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

Символьный код раздела

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

Описание раздела

PICTURE file необязательный

Картинка раздела. Формат файла — в статье Как загрузить файлы

DETAIL_PICTURE file необязательный

Детальная картинка раздела. Формат файла — в статье Как загрузить файлы

UF_ any необязательный

Пользовательские поля раздела UF_*.

Передаются отдельными параметрами в формате "UF_КОД": значение, например: "UF_COLOR": "#ff6600"

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ENTITY":"dish","ID":673,"NAME":"Тестовый раздел (обновлен)","SECTION":671,"ACTIVE":"Y","SORT":550,"CODE":"testovyy-razdel-updated","DESCRIPTION":"Обновленное описание","PICTURE":["section.jpg","**base64_section_image**"],"DETAIL_PICTURE":["section-detail.jpg","**base64_section_detail_image**"],"UF_COLOR":"#ff6600","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/entity.section.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1774341623,
        "finish": 1774341623.380336,
        "duration": 0.38033604621887207,
        "processing": 0,
        "date_start": "2026-03-24T11:40:23+03:00",
        "date_finish": "2026-03-24T11:40:23+03:00",
        "operating_reset_at": 1774342223,
        "operating": 0.1318378448486328
    }
}

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

result boolean

Результат выполнения метода. Для успешного обновления возвращается true

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_SECTION_NOT_FOUND",
    "error_description": "Section not found"
}
Код Описание Значение
ERROR_ARGUMENT Argument 'ENTITY' is null or empty Параметр ENTITY не передан или пустой после очистки
ERROR_ARGUMENT Entity code is too long. Max length is N characters. Слишком длинное значение ENTITY
ERROR_ARGUMENT Argument 'ID' is null or empty Параметр ID не передан или имеет значение 0
ERROR_ENTITY_NOT_FOUND Entity not found Хранилище с переданным ENTITY не найдено
ERROR_SECTION_NOT_FOUND Section not found Раздел с указанным ID не найден в этом хранилище
ACCESS_DENIED Access denied! Недостаточно прав для обновления раздела
ERROR_CORE Internal error updating entity section. Try updating again. Внутренняя ошибка при обновлении раздела
ERROR_CORE Неверный тип файла Передан файл неподдерживаемого типа в PICTURE или DETAIL_PICTURE

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

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