Get status

Returns the details of a single status.

Request

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

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string	Yes	Unique status ID

Note: A deleted status returns 200 OK, not 404 — the deleted field distinguishes the two cases.

Response

Success (200 OK)

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

Response fields

Field	Type	Description
data.id	string (UUID)	Unique status ID
data.name	string	Name of the status (freely configurable per company)
data.type	string	Stable status category: open, in_progress, or done
data.color	string	Color of the status (hex)
data.deleted	boolean	true if the status has been deleted

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}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope todos not present
404	not_found	Status not found