knowledgebase.section.update

Scope: knowledgebase

Кто может вызывать: IblockRights::canEditSection(); смена родителя — canAddSubsectionInSection() или canEditIblockRights() для корня. Подробнее: Права доступа

Обновить раздел базы знаний

HTTP: POST

Побочные эффекты: обновляет раздел инфоблока

Параметры метода

Параметр Тип Обяз. Описание
id int да ID раздела (алиас: sectionId)
name string нет Новое название
parentId int нет ID нового родительского раздела; 0 — переместить в корень (алиас: IBLOCK_SECTION_ID)

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

Ответ в конверте модуля: result.result — обновлённый раздел (формат как у section.get); result.error.

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

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Некорректные параметры или ошибка записи
PERMISSION_DENIED Нет прав на редактирование или перемещение раздела
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/knowledgebase.section.update.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          --data '{
          "id": 55,
          "name": "Переименованный раздел"
        }'

Пример ответа

{
          "result": {
            "result": {
              "id": 111,
              "name": "REST Docs Temp Section Updated",
              "parentId": 96,
              "left": 2,
              "right": 3,
              "depth": 2,
              "count": 0
            },
            "error": null
          }
        }

См. также

Предыдущая
knowledgebase.section.list
Следующая
Обзор раздела