Contents

POST [/instances/$INSTANCE]/private/categories#

This is used to create a new category for the inventory. Since API version v16.

Required permission: categories-write

Request:

The request is a CategoryCreateRequest.

Response:

200 Ok:

The response is a CategoryCreatedResponse.

Details:

interface CategoryCreateRequest {

  // Name of the category.
  name: string;

  // Translations of the name into various
  // languages.
  name_i18n?: { [lang_tag: string]: string };

}
interface CategoryCreatedResponse {

  // Number of the newly created category.
  category_id: Integer;
}