Tag erstellen

POST /api/tags

BodyAnkerlink kopieren

{
  "name": "Produktion",
  "color": "red"
}

• name (erforderlich): Anzeigename des Tags (max. 50 Zeichen).
• color (erforderlich): Einer der Palette-Schlüssel: slate | red | amber | green | teal | blue | indigo | violet | pink | gray.

Beispiel (cURL)Ankerlink kopieren

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/tags" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Produktion","color":"red"}'

Antwort (Response)Ankerlink kopieren

{
  "id": 1,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "name": "Produktion",
  "color": "red",
  "createdBy": 42,
  "createdAt": "2026-06-29T10:00:00.000Z",
  "updatedAt": "2026-06-29T10:00:00.000Z"
}

Häufige FehlerAnkerlink kopieren

• 400 invalidTagColor wenn color kein gültiger Palette-Schlüssel ist
• 400 Bad Request wenn name fehlt oder das Zeichenlimit überschreitet
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden wenn du keinen Zugriff auf die Organisation hast
• 403 authorizingUserUnresolved wenn der Aufruf über eine Agenten-Sitzung kommt, deren autorisierender Mensch nicht mehr auflösbar ist; ein Etikett hält immer diesen Menschen als Urheber fest, nie den Agenten, das Etikett entsteht also nicht (siehe Fehlerliste und bekannte API-Fallen)