Tag abfragen
Gibt einen Tag per numerischer ID oder publicId zurück, in derselben Form wie ein Eintrag von „Tags auflisten“.
GET /api/tags/{id}
Zugriff
Dieselbe Sichtbarkeit wie Tags auflisten: Nutzer mit Kundenbeschränkung sehen die Tags ihrer Kunden und selbst angelegte Tags; ein Tag außerhalb davon antwortet 404.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/tags/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Antwort (Response)
200 OK
{
"id": 1,
"publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"organizationId": 10,
"customerId": null,
"name": "Production",
"color": "red",
"createdBy": "u_abc123",
"createdAt": "2026-06-01T08:00:00.000Z",
"updatedAt": "2026-06-01T08:00:00.000Z",
"customer": null,
"owner": {
"id": "u_abc123",
"name": "Ada Admin",
"email": "ada@example.com"
},
"customers": []
}Häufige Fehler
400 Bad Request, wenn die ID weder Zahl noch UUID ist401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden, wenn dein Konto keiner Organisation angehört404 Not Found(tagNotFound), wenn der Tag nicht existiert oder für dich nicht sichtbar ist