Uptimeify Docs

Tag aktualisieren

Aktualisiert Name oder Farbe eines bestehenden Tags. Nur der Ersteller des Tags oder ein Admin darf ihn verändern.

PATCH /api/tags/{id}

Pfadparameter {id} ist die numerische id des Tags.

Body

Alle Felder sind optional; sende nur die Felder, die du ändern möchtest.

{
  "name": "Kritisch",
  "color": "violet"
}
  • name (optional): Neuer Anzeigename (max. 50 Zeichen).
  • color (optional): 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>"
TAG_ID=1

curl -X PATCH "$BASE_URL/api/tags/$TAG_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kritisch","color":"violet"}'

Antwort (Response)

{
  "id": 1,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "name": "Kritisch",
  "color": "violet",
  "createdBy": 42,
  "createdAt": "2026-06-01T08:00:00.000Z",
  "updatedAt": "2026-06-29T11:00:00.000Z"
}

Häufige Fehler

  • 400 invalidTagColor wenn color kein gültiger Palette-Schlüssel ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du nicht der Ersteller des Tags oder ein Admin bist
  • 404 Not Found wenn der Tag nicht existiert oder für dich nicht sichtbar ist

Auf dieser Seite