API reference · Statuses
POST/api/v1/statuses

Create status

Creates a new status. For ticket statuses, board_id is required. The status_type must be one of: ticket, project, project_task, interaction.

RBAC · ticket

Request body

Content type: application/json · schema StatusCreateRequest

namestringRequired
min length 1 · max length 255
status_typestringRequired
Enum: ticketprojectproject_taskinteraction
board_idstring <uuid>
is_closedboolean
is_defaultboolean
order_numberinteger
≥ 0
colorstring
pattern /^#[0-9A-Fa-f]{6}$/
iconstring
max length 50

Response body

Success response 201 · schema StatusEnvelope

dataobjectRequired
status_idstring <uuid>Required
namestringRequired
status_typestringRequired
Enum: ticketprojectproject_taskinteraction
order_numbernumberRequired
is_closedbooleanRequired
is_defaultbooleanRequiredNullable
item_typestringRequiredNullable
standard_status_idstringRequiredNullable
is_custombooleanRequiredNullable
tenantstring <uuid>Required

Response codes

201
Status created successfully.
400
Validation error.
401
Authentication failed.
403
Authenticated user lacks the required permission.