Status
Organisationsweite Workflow-Status verwalten, die Boards verwenden können.
Status definieren die Phasen deines Workflows auf Organisationsebene. Jeder Status gehört zu einer Kategorie (PLANNING, ACTIVE oder FINAL), die bestimmt, wie Spedy Tickets in dieser Phase behandelt. Boards erben diese globalen Status und können anpassen, welche sichtbar sind.
Status auflisten
GET /api/v1/statusesGibt alle Status der Organisation zurück.
Beispiel-Response
{
"data": [
{
"id": "sts_abc123",
"name": "Backlog",
"color": "#6B7280",
"category": "PLANNING",
"order": 0,
"isDefault": true,
"isFinal": false,
"isMandatory": true
},
{
"id": "sts_def456",
"name": "In Bearbeitung",
"color": "#3B82F6",
"category": "ACTIVE",
"order": 2,
"isDefault": false,
"isFinal": false,
"isMandatory": false
},
{
"id": "sts_ghi789",
"name": "Erledigt",
"color": "#10B981",
"category": "FINAL",
"order": 4,
"isDefault": false,
"isFinal": true,
"isMandatory": true
}
]
}Status erstellen
POST /api/v1/statusesBerechtigung erforderlich: settings:manage-statuses
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Ja | Status-Name (max. 50 Zeichen) |
| color | string | Ja | Farbe im Hex-Format (z.B. #3B82F6) |
| category | string | Nein | PLANNING, ACTIVE oder FINAL |
| order | number | Nein | Anzeigereihenfolge |
| isDefault | boolean | Nein | Standard-Status für neue Tickets |
| isFinal | boolean | Nein | Markiert Tickets als abgeschlossen |
| enabledByDefault | boolean | Nein | Anfangs auf allen Boards aktiviert |
Beispiel-Request
{
"name": "In Review",
"color": "#8B5CF6",
"category": "ACTIVE",
"order": 3
}Status abrufen
GET /api/v1/statuses/{statusId}Gibt einen einzelnen Status zurück.
Status aktualisieren
PATCH /api/v1/statuses/{statusId}Berechtigung erforderlich: settings:manage-statuses
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Status-Name |
| color | string | Nein | Farbe im Hex-Format |
| category | string | Nein | PLANNING, ACTIVE oder FINAL |
| order | number | Nein | Anzeigereihenfolge |
Status löschen
DELETE /api/v1/statuses/{statusId}Berechtigung erforderlich: settings:manage-statuses
Löscht einen Status. Pflicht-Status können nicht gelöscht werden. Gibt 204 No Content zurück.
Status neu ordnen
POST /api/v1/statuses/reorderBerechtigung erforderlich: settings:manage-statuses
Aktualisiert die Anzeigereihenfolge aller Status auf einmal.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| statusIds | string[] | Ja | Geordnete Liste der Status-IDs |
Beispiel-Request
{
"statusIds": ["sts_abc123", "sts_def456", "sts_ghi789"]
}