Tags
List Tags
Returns all tags visible to the caller. Readonly members see only tags they created themselves.
GET /api/tags
Query Parameters
organizationId(optional): Defaults to your session organization.
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/tags" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Response
[
{
"id": 1,
"publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"organizationId": 10,
"name": "Production",
"color": "red",
"createdBy": 42,
"createdAt": "2026-06-01T08:00:00.000Z",
"updatedAt": "2026-06-01T08:00:00.000Z"
},
{
"id": 2,
"publicId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
"organizationId": 10,
"name": "Staging",
"color": "amber",
"createdBy": 42,
"createdAt": "2026-06-10T09:00:00.000Z",
"updatedAt": "2026-06-10T09:00:00.000Z"
}
]Common errors
401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you cannot access the organization