ipr.position.add

Scope: ipr

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

Создаёт должность в каталоге.

HTTP: POST

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

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

Параметр Тип Обяз. Описание
title (алиас name) string да Название, 1..255 символов
description (алиас detailText) string нет Описание
active bool нет По умолчанию true
sectionId int нет Раздел каталога
levelUp (алиас levelUpIds) int[] нет ID должностей вертикального роста
level string нет Грейд/уровень
levelUpHorizontal (алиас levelUpHor) int[] нет ID должностей горизонтального перехода
requiredCompetenceIds (алиас compReq) int[] нет Обязательные компетенции каталога
recommendedCompetenceIds (алиас compRecom) int[] нет Рекомендованные компетенции каталога
competenceLevels object нет Карта требуемых уровней по компетенциям (произвольная структура)

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

Полная должность — та же форма, что у ipr.position.get.

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

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.position.add.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "title": "Ведущий аналитик",
          "sectionId": 4,
          "requiredCompetenceIds": [1049, 1051]
        }'

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

{
          "result": {
            "result": {
              "id": 305,
              "title": "Ведущий аналитик",
              "sectionId": 4,
              "requiredCompetenceIds": [1049, 1051]
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

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