List task statuses

GET /v1/task-statuses

Returns every task status configured in the team the API key is bound to, sorted by order ascending. Use this to discover valid taskStatusId values for Create a task.

Request

This endpoint takes no query parameters or body.

Response

200 OK — array of task status objects:

Field	Type	Description
id	number	Numeric ID of the status. Pass this as taskStatusId when creating a task.
name	string	Display name of the status.
color	string | null	Hex color used in the UI, or null if not set.
isDefault	boolean	true for the status applied to new tasks when none is specified.
isCompleted	boolean	true if tasks in this status are considered done.
order	number	Sort position used in the UI.

Example response

[
  { "id": 1, "name": "Backlog",     "color": "#94a3b8", "isDefault": true,  "isCompleted": false, "order": 0 },
  { "id": 2, "name": "Todo",        "color": "#64748b", "isDefault": false, "isCompleted": false, "order": 1 },
  { "id": 3, "name": "In progress", "color": "#3b82f6", "isDefault": false, "isCompleted": false, "order": 2 },
  { "id": 4, "name": "Done",        "color": "#22c55e", "isDefault": false, "isCompleted": true,  "order": 3 }
]