Task Statuses

10 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

List task statuses for the org (optionally filtered by space)#

GET/task-statusesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`	Query	`string`	–
`is_active`	Query	`string`	–
`is_completed`	Query	`string`	–
`search`	Query	`string`	–
`with_transitions`	Query	`string`	–

Antworten

200Statuses returned

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/task-statuses" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a task status#

POST/task-statusesToken

Request-Body`application/jsonCreateTaskStatusDto`

Name	Typ	Beschreibung
`organizationId`	`string`	Legacy frontend compatibility only; ignored in favor of the authenticated organization.
`name`Pflicht	`string`	Beispiel: `In Review`
`key`Pflicht	`string`	Unique key (lowercase, underscores). Immutable after creation. Beispiel: `in_review`
`color`Pflicht	`string`	Hex color (#RRGGBB) Beispiel: `#F59E0B`
`icon`	`object`	Beispiel: `lucide:eye`
`space_id`	`object`	Space ID (null = org-level)
`category_id`	`string`	Status category (To Do / In Progress / Done bucket). If omitted, the DB trigger auto-links by is_completed. Explicit null is not allowed — omit the field instead.
`sort_order`	`number`	Beispiel: `0`
`is_default`	`boolean`	Standard: `false`
`is_completed`	`boolean`	Marks terminal/completed states (e.g. Done, Closed) Standard: `false`
`is_active`	`boolean`	Standard: `true`
`allowed_transitions`	`string[]`	IDs of statuses this status can transition to

Antworten

201Status created

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/task-statuses" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"In Review","key":"in_review","color":"#F59E0B"}'

Get a task status by ID#

GET/task-statuses/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`with_transitions`	Query	`string`	Embed allowed transition IDs

Antworten

200Status returned

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update a task status#

PUT/task-statuses/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateTaskStatusDto`

Name	Typ	Beschreibung
`organizationId`	`string`	Legacy frontend compatibility only; ignored in favor of the authenticated organization.
`name`	`string`	Beispiel: `In Review`
`key`	`string`	Immutable. Accepted only when equal to the stored key; a different key is rejected. Beispiel: `in_review`
`color`	`string`	Beispiel: `#F59E0B`
`icon`	`object`	Beispiel: `lucide:eye`
`sort_order`	`number`	Beispiel: `0`
`is_default`	`boolean`	–
`is_completed`	`boolean`	–
`is_active`	`boolean`	–
`allowed_transitions`	`string[]`	Replace the full transition target list
`category_id`	`string`	Status category (To Do / In Progress / Done bucket). Explicit null is not allowed — omit the field to leave unchanged.

Antworten

200Status updated

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organizationId":"…","name":"In Review","key":"in_review"}'

Patch action: toggle_active, set_default, reorder, duplicate#

PATCH/task-statuses/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonPatchTaskStatusDto`

Name	Typ	Beschreibung
`organizationId`	`string`	Legacy frontend compatibility only; ignored in favor of the authenticated organization.
`action`Pflicht	`string`	Werte: `toggle_activeset_defaultreorderduplicate`
`name`	`string`	Legacy PATCH compatibility: partial update when action is omitted. Beispiel: `In Review`
`key`	`string`	Legacy PATCH compatibility: immutable; accepted only when equal to the stored key when action is omitted. Beispiel: `in_review`
`color`	`string`	Legacy PATCH compatibility: partial update when action is omitted. Beispiel: `#F59E0B`
`icon`	`object`	Legacy PATCH compatibility: partial update when action is omitted. Beispiel: `lucide:eye`
`sort_order`	`number`	Legacy PATCH compatibility: partial update when action is omitted. Beispiel: `0`
`is_default`	`boolean`	Legacy PATCH compatibility: partial update when action is omitted.
`is_completed`	`boolean`	Legacy PATCH compatibility: partial update when action is omitted.
`is_active`	`boolean`	For toggle_active
`allowed_transitions`	`string[]`	Legacy PATCH compatibility: replace transition target IDs when action is omitted.
`new_name`	`string`	For duplicate
`category_id`	`string`	Legacy PATCH compatibility: status category bucket when action is omitted. Explicit null is not allowed.
`items`	`string[]`	For reorder — array of { id, sort_order }

Antworten

200Action applied

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"toggle_active"}'

Delete a task status (blocked if in use by tasks)#

DELETE/task-statuses/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200Status deleted

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List allowed transition target IDs for a status#

GET/task-statuses/{id}/transitionsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200Transition IDs returned

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}/transitions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a single transition target#

POST/task-statuses/{id}/transitionsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Transition added

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}/transitions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bulk-replace transition targets for a status#

PUT/task-statuses/{id}/transitionsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200Transitions replaced

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}/transitions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Remove a single transition target#

DELETE/task-statuses/{id}/transitionsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200Transition removed

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/task-statuses/{id}/transitions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Task Statuses

List task statuses for the org (optionally filtered by space)#

Parameter

Antworten

Create a task status#

Request-Bodyapplication/jsonCreateTaskStatusDto

Antworten

Get a task status by ID#

Parameter

Antworten

Update a task status#

Parameter

Request-Bodyapplication/jsonUpdateTaskStatusDto

Antworten

Patch action: toggle_active, set_default, reorder, duplicate#

Parameter

Request-Bodyapplication/jsonPatchTaskStatusDto

Antworten

Delete a task status (blocked if in use by tasks)#

Parameter

Antworten

List allowed transition target IDs for a status#

Parameter

Antworten

Add a single transition target#

Parameter

Antworten

Bulk-replace transition targets for a status#

Parameter

Antworten

Remove a single transition target#

Parameter

Antworten

Request-Body`application/jsonCreateTaskStatusDto`

Request-Body`application/jsonUpdateTaskStatusDto`

Request-Body`application/jsonPatchTaskStatusDto`