# 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.next — null; result.error — ошибка или null; total — 0.
Обработка ошибок
Справочник кодов: 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
}