Create a new category
- 05 Dec 2024
- 1 Minute to read
- Print
Create a new category
- Updated on 05 Dec 2024
- 1 Minute to read
- Print
Article summary
Did you find this summary helpful?
Thank you for your feedback
Post
/v{version}/Categories
Only admins can access this endpoint.
Security
API Key
Header parameter nameX-ApiKey
Api Key
API Key
Header parameter nameX-Session-Id
Session Id
Path parameters
version
stringRequired
The requested API version
Default"1.18"
Body parameters
Creation request that contains information for creating a new category
object
Request that contains information for creating a new category
Name
string Required
Name of the category
ParentId
integer (int32)
Unique ID of the parent category
Minimum1.0
Maximum2147483647.0
Permissions
object Required
Permissions of the category
property*
object additionalProperties
Read
boolean
Write
boolean
Selectable
boolean
If true, the category is selectable in the IXM Platform. Default: false.
Responses
200
OK
object
Category
Created
string (date-time)
Creation date in UTC
Id
integer (int32)
Unique ID of the category
Modified
string (date-time)
Modification date in UTC
Name
string
Name of the category
ParentId
integer (int32)
Unique ID of the parent category
Permissions
object
Permissions of the category
Read
boolean
Write
boolean
Selectable
boolean
If true, the category is selectable in the IXM Platform. Default: false.
400
Bad request
object
ValidationErrors
object
property*
Array of string additionalProperties
string
403
Access denied
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties
500
Unexpected error
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties
.png?sv=2022-11-02&spr=https&st=2025-02-06T16%3A59%3A48Z&se=2025-02-06T17%3A14%3A48Z&sr=c&sp=r&sig=Az2a4FDW0KsEcWFoR1D0CxF9wyq8y%2BfdYtIyjVXJ3AI%3D)