ipr.competency.update

Scope: ipr

Кто может вызывать: canManageCatalog() — группа «может управлять ИПР» либо admin/hr. Подробнее: Модель доступа

Изменяет компетенцию каталога. Передаются только те поля, которые нужно изменить.

HTTP: POST

Побочные эффекты: Изменяет элемент инфоблока компетенций.

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

Параметр Тип Обяз. Описание
id int да ID компетенции
title (алиас name) string нет Название, 1..255 символов
description (алиас previewText) string нет Описание
sectionId (алиас iblockSectionId) int нет Раздел каталога
sort int нет Сортировка
active bool нет Активность
status string нет active | inactive — альтернатива active
level int нет Уровень компетенции
iconCode (алиас icon) string нет Код иконки
iconColor int нет ID цвета иконки

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

Полная компетенция — та же форма, что у ipr.competency.get.

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

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.competency.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{"id": 1049, "level": 3}'

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

{
          "result": {
            "result": {
              "id": 1049,
              "level": 3
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

Предыдущая
ipr.competency.add
Следующая
ipr.competency.delete