SpedySpedy Docs

Board-Status

Anzeigen und konfigurieren, welche Workflow-Status auf einem Board aktiv sind.

Jedes Board hat eine eigene Status-Konfiguration, die auf den globalen Status der Organisation aufbaut. Du kannst Status pro Board anzeigen, ausblenden oder anpassen, um den Workflow jedes Projekts abzubilden.

Board-Status auflisten

GET /api/v1/boards/{boardId}/statuses

Query-Parameter

ParameterTypPflichtBeschreibung
categorystringNeinNach Kategorie filtern: PLANNING, ACTIVE oder FINAL
includeHiddenbooleanNeinAusgeblendete Status einschließen (Standard: false)

Beispiel-Response

{
  "data": [
    {
      "id": "sts_abc123",
      "name": "Backlog",
      "color": "#6B7280",
      "category": "PLANNING",
      "order": 0,
      "isHidden": false,
      "isDefault": true
    },
    {
      "id": "sts_def456",
      "name": "In Bearbeitung",
      "color": "#3B82F6",
      "category": "ACTIVE",
      "order": 2,
      "isHidden": false,
      "isDefault": false
    }
  ]
}

Board-Status-Konfiguration aktualisieren

PATCH /api/v1/boards/{boardId}/statuses/{statusId}

Berechtigung erforderlich: settings:manage-statuses

Passe an, wie ein globaler Status auf diesem Board angezeigt wird (z.B. ausblenden oder Anzeigereihenfolge ändern).

Request Body

FeldTypPflichtBeschreibung
isHiddenbooleanNeinOb dieser Status auf dem Board ausgeblendet werden soll
ordernumberNeinPosition in der Anzeigereihenfolge

Board-Status-Konfiguration zurücksetzen

DELETE /api/v1/boards/{boardId}/statuses/{statusId}

Berechtigung erforderlich: settings:manage-statuses

Setzt eine Board-spezifische Status-Überschreibung auf die Organisations-Standardwerte zurück. Gibt 204 No Content zurück.