ipr.competency.add

Scope: ipr

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

Создаёт компетенцию в каталоге.

HTTP: POST

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

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

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

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

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

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Не передан обязательный параметр, title длиннее 255 символов
PERMISSION_DENIED Нет прав управлять каталогом компетенций
INTERNAL_ERROR Не удалось создать компетенцию / каталог не настроен

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.competency.add.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "title": "Работа с обратной связью",
          "sectionId": 12,
          "level": 2,
          "iconCode": "feedback"
        }'

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

{
          "result": {
            "result": {
              "id": 1049,
              "title": "Работа с обратной связью",
              "sectionId": 12,
              "active": true
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

Предыдущая
ipr.competency.get
Следующая
ipr.competency.update