XISUITEDokumentation

Task Priorities

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

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

GET/task-prioritiesToken

Parameter

NameOrtTypBeschreibung
spaceIdQuerystring–
is_activeQuerystring–
searchQuerystring–

Antworten

  • 200Priorities returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/task-priorities" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a task priority#

POST/task-prioritiesToken

Request-Bodyapplication/jsonCreateTaskPriorityDto

NameTypBeschreibung
organizationIdstring

Legacy frontend compatibility only; ignored in favor of the authenticated organization.

namePflichtstring

Beispiel: Critical

keyPflichtstring

Unique key (lowercase, underscores). Immutable after creation.

Beispiel: critical

colorPflichtstring

Hex color (#RRGGBB)

Beispiel: #EF4444

iconobject

Beispiel: lucide:chevrons-up

space_idobject

Space ID (null = org-level)

sort_ordernumber

Beispiel: 0

is_defaultboolean

Standard: false

is_activeboolean

Standard: true

Antworten

  • 201Priority created
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/task-priorities" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Critical","key":"critical","color":"#EF4444"}'

Get a task priority by ID#

GET/task-priorities/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Antworten

  • 200Priority returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/task-priorities/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update a task priority#

PUT/task-priorities/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Request-Bodyapplication/jsonUpdateTaskPriorityDto

NameTypBeschreibung
organizationIdstring

Legacy frontend compatibility only; ignored in favor of the authenticated organization.

namestring

Beispiel: Critical

colorstring

Beispiel: #EF4444

iconobject

Beispiel: lucide:chevrons-up

sort_ordernumber

Beispiel: 0

is_defaultboolean–
is_activeboolean–

Antworten

  • 200Priority updated
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/task-priorities/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organizationId":"…","name":"Critical","color":"#EF4444"}'

Patch action: toggle_active, set_default, reorder, duplicate#

PATCH/task-priorities/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Request-Bodyapplication/jsonPatchTaskPriorityDto

NameTypBeschreibung
organizationIdstring

Legacy frontend compatibility only; ignored in favor of the authenticated organization.

actionPflichtstring

Werte: toggle_activeset_defaultreorderduplicate

namestring

Legacy PATCH compatibility: partial update when action is omitted.

Beispiel: Critical

colorstring

Legacy PATCH compatibility: partial update when action is omitted.

Beispiel: #EF4444

iconobject

Legacy PATCH compatibility: partial update when action is omitted.

Beispiel: lucide:chevrons-up

sort_ordernumber

Legacy PATCH compatibility: partial update when action is omitted.

Beispiel: 0

is_defaultboolean

Legacy PATCH compatibility: partial update when action is omitted.

is_activeboolean

For toggle_active

new_namestring

For duplicate

itemsstring[]

For reorder — array of { id, sort_order }

Antworten

  • 200Action applied
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/task-priorities/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"toggle_active"}'

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

DELETE/task-priorities/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring–

Antworten

  • 200Priority deleted
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/task-priorities/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions