API reference · Ticket Categories
POST/api/v1/categories/ticket

Create ticket category

Creates a ticket category row for one board. Requires ticket_settings:create permission.

RBAC · ticket_settings

Request body

Content type: application/json · schema TicketCategoryCreateRequest

category_namestringRequired
min length 1 · max length 255
board_idstring <uuid>Required
parent_categorystring <uuid>
descriptionstring
max length 1000

Response body

Success response 201

dataobjectRequired
Ticket category resource from ticket_categories, including optional hierarchy fields.
category_idstring <uuid>Required
category_namestringRequired
parent_categorystring <uuid>Nullable
board_idstring <uuid>Required
descriptionstringNullable
created_bystring <uuid>Required
updated_bystring <uuid>Required
created_atstring <date-time>
updated_atstring <date-time>
tenantstring <uuid>Required
childrenarray of any
itemsany
depthnumber
pathstring
children_countnumber

Response codes

201
Ticket category created successfully.
400
Invalid request payload.
401
Authentication failed.
403
Authenticated user lacks ticket settings create permission.