POST /orgs/{oid}/categories

Creates a new category in an organization.

Refer to category for all the mandatory and optional attributes.


Only administrators have the ability to create and manage categories

Security Summary

  • Requires Authentication: true
  • Entitlements Required: categories_administrate

URI Parameters

  • oid (required): the id of the org

HTTP Request Body Parameters

A category object

Example Request

curl "{oid}/categories" -X POST \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml" --data-binary "@representation.xml"

Example of representation.xml content (the request body):

<ns0:category xmlns:ns0="">
        <name>Category Example</name>