ipr.position.update

Scope: ipr

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

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

HTTP: POST

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

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

Параметр Тип Обяз. Описание
id int да ID должности
title (алиас name) string нет Название, 1..255 символов
description (алиас detailText) string нет Описание
active bool нет Активность
sectionId int нет Раздел каталога (0 снимает привязку)
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 Некорректные значения полей
NOT_FOUND Должность не найдена
PERMISSION_DENIED Нет прав управлять каталогом должностей
INTERNAL_ERROR Внутренняя ошибка сервера

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.position.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{"id": 305, "recommendedCompetenceIds": [1052, 1053]}'

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

{
          "result": {
            "result": {
              "id": 305,
              "recommendedCompetenceIds": [1052, 1053]
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

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