Skip to content

Status anzeigen ​

Gibt die Details eines einzelnen Status zurück.

Request ​

GET /api/oauth/v2/resource/todos/statuses/{uuid}

HeaderWert
AuthorizationBearer {access_token}

URL-Parameter ​

ParameterTypPflichtBeschreibung
uuidstringJaEindeutige Status-ID

Hinweis: Ein gelöschter Status liefert 200 OK, nicht 404 – das Feld deleted unterscheidet die beiden Fälle.

Response ​

Erfolg (200 OK) ​

json
{
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "name": "Offen",
    "type": "open",
    "color": "#00adba",
    "deleted": false
  }
}

Response-Felder ​

FeldTypBeschreibung
data.idstring (UUID)Eindeutige Status-ID
data.namestringName des Status (frei konfigurierbar pro Unternehmen)
data.typestringStabile Status-Kategorie: open, in_progress oder done
data.colorstringFarbe des Status (Hex)
data.deletedbooleantrue, wenn der Status gelöscht wurde
Beispiele
bash
curl -X GET "https://my.offisy.at/api/oauth/v2/resource/todos/statuses/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"
Parameter
Zuerst Token anfordern

Mögliche Fehler ​

StatusCodeBeschreibung
401invalid_clientUngültiger oder fehlender Access Token
403insufficient_scopeScope todos nicht vorhanden
404not_foundStatus nicht gefunden

Offisy GmbH