Метод updateCategoryById

Изменение категории конфигураций по идентификатору.

PUT /v1/categories/{categoryId}

Параметр пути

Имя Описание Обязательный Тип Пример

categoryId

Идентификатор категории конфигурации

Да

string

Сеть

Параметры тела запроса

CategoryUpdateRequest

Пример запроса

{
  "color": "00ff00",
  "name": "Офис",
  "description": "Категория программ для работы в сети Интернет",
  "iconCode": "ms_office_icon"
}

Тип контента

application/json

Ответы

Код Сообщение Тип данных / объект схемы (DTO) Пример

200

Представление категории конфигурации

CategoryResponse

 
{
  "createdAt": "2023-08-27T09:37:40.000Z",
  "color": "00ff00",
  "name": "Офис",
  "description": "Категория программ для работы в сети Интернет",
  "iconCode": "ms_office_icon",
  "id": "office",
  "updatedAt": "2023-08-27T09:37:40.000Z"
}

400

Некорректные параметры запроса

BasicError

 
{
  "code": "validation_failed",
  "message": "updateCategoryById.categoryUpdateRequest.color: must match `[A-Fa-f0-9]+`"
}

401

Ошибка аутентификации

404

Объект не найден

BasicError

 
{
  "code": "object_not_found",
  "message": "Category with id=officeCategory not found"
}

500

Внутренняя ошибка

BasicError

 
{
  "code": "internal_error",
  "message": "Database is unavailable"
}