Tag erstellen

Erstellt einen neuen Tag in deiner Organisation. Readonly-Mitglieder können Tags erstellen, die nur für sie selbst sichtbar sind.

POST /api/tags

Body

{
  "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)

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)

{
  "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 Fehler

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

Tag einem Monitor zuweisen

Weist einem Monitor einen bestehenden Tag zu. Der Aufrufer benötigt Lesezugriff auf den Monitor und Sichtbarkeit des Tags. Die Operation ist idempotent.

Tag löschen

Löscht einen Tag und entfernt ihn von allen Monitoren, denen er zugewiesen war. Nur der Ersteller oder ein Admin darf löschen.

Auf dieser Seite

Body Beispiel (cURL)Antwort (Response)Häufige Fehler