Skip to content

Get tag ​

Returns the details of a single tag.

Request ​

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

HeaderValue
AuthorizationBearer {access_token}

URL parameters ​

ParameterTypeRequiredDescription
uuidstringYesUnique tag ID

Response ​

Success (200 OK) ​

json
{
  "data": {
    "id": "e5f6a7b8-9012-3456-ef01-567890123456",
    "name": "Urgent",
    "color": "#df3a7f"
  }
}

Response fields ​

FieldTypeDescription
data.idstring (UUID)Unique tag ID
data.namestringName of the tag
data.colorstringColor of the tag (hex)
Beispiele
bash
curl -X GET "https://my.offisy.at/api/oauth/v2/resource/todos/tags/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"
Parameter
Zuerst Token anfordern

Possible errors ​

StatusCodeDescription
401invalid_clientInvalid or missing access token
403insufficient_scopeScope todos not present
404not_foundTag not found

Offisy GmbH