# assessment360.competency.category.update

Scope: assessment360

Кто может вызывать: Администратор портала или группа HR-отдела из настроек модуля. См. Права доступа

Обновляет категорию компетенций.

HTTP: POST

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

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

Параметр Тип Обяз. Описание
id int да Идентификатор записи
name string нет Название категории
active bool нет Активность категории
parentId int нет ID родительской категории, 0 = корень
sort int нет Сортировка
color string нет Цвет категории

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

Ответ возвращается в конверте модуля: result.result — объект категории (id, name, active, parentId, sort, color); result.nextnull; result.error — ошибка или null; total0.

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

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.competency.category.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "id": 5,
          "name": "Soft skills (обновлённая)",
          "active": true,
          "parentId": 0,
          "sort": 500,
          "color": "#FF5733"
        }'
        

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

{
          "result": {
            "result": {
              "id": 5,
              "name": "Soft skills (обновлённая)",
              "active": true,
              "parentId": 0,
              "sort": 500,
              "color": "#FF5733"
            },
            "next": null,
            "error": null
          },
          "total": 0
        }
        

См. также