Status Categories
6 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1
List status categories for the org#
GET
/status-categoriesTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | string | – |
Antworten
- 200Categories returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/status-categories" \
-H "Authorization: Bearer $XISUITE_TOKEN"Create a status category#
POST
/status-categoriesTokenRequest-Body
| Name | Typ | Beschreibung |
|---|---|---|
namePflicht | string | |
keyPflicht | string | |
colorPflicht | string | |
text_color | string | |
space_id | object | Space ID (null = org-level) |
sort_order | number | |
is_done_like | boolean |
Antworten
- 201Category created
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/status-categories" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"In Review","key":"in_review","color":"#3B82F6"}'Get a status category by ID#
GET
/status-categories/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
Antworten
- 200Category returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/status-categories/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Update a status category#
PUT
/status-categories/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
name | string | – |
color | string | – |
text_color | string | – |
sort_order | number | – |
is_done_like | boolean | – |
Antworten
- 200Category updated
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/status-categories/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"…","color":"…","text_color":"…"}'Delete a status category (blocked if is_system=true)#
DELETE
/status-categories/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
Antworten
- 200Category deleted
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/status-categories/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Bulk reorder status categories#
PATCH
/status-categories/reorderTokenRequest-Body
| Name | Typ | Beschreibung |
|---|---|---|
itemsPflicht | ReorderItemDto[] | – |
Antworten
- 200Categories reordered
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/status-categories/reorder" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"items":[]}'