Komponentengruppe aktualisieren
Benennt eine Komponentengruppe um, verschiebt oder klappt sie zu.
PATCH /api/status-pages/{id}/groups/{groupId}
Zugriff
Organisations-admin und editor. Ein kundengebundener Nutzer oder API-Token erreicht nur Seiten eines Kunden in seinem Bereich; eine Seite ohne Kunde (customerId: null) beantwortet ihm 403 (forbidden). Eine Seite einer anderen Organisation antwortet 404 (statusPageNotFound). IDs im Pfad nehmen die numerische ID oder die publicId. Die Änderung steht im Audit-Protokoll der Organisation.
Request-Body (alle optional, mindestens ein Feld)
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Überschrift der Gruppe (1-120 Zeichen). |
sort | number | Position, 0-100000. |
collapsed | boolean | Auf der öffentlichen Seite zugeklappt starten. |
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X PATCH "$BASE_URL/api/status-pages/1/groups/3" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "collapsed": true }'Antwort
200 OK mit der geänderten Gruppe, in derselben Form wie bei Komponentengruppen auflisten.
Häufige Fehler
400 Bad Request(invalidRequestBody), wenn der Body leer oder ein Feld ungültig ist400 Bad Request(invalidIdentifier), wenn eine ID im Pfad weder Zahl noch UUID ist401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden(forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden403 Forbidden(statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist404 Not Found(statusPageNotFound), wenn die Status-Seite nicht existiert oder zu einer anderen Organisation gehört404 Not Found(statusPageComponentGroupNotFound), wenn es die Gruppe auf dieser Seite nicht gibt
Statusseite abonnieren
Öffentlicher Endpunkt hinter dem Abo-Formular: E-Mail, Webhook, Slack oder Microsoft Teams, für die ganze Seite oder einzelne Komponenten. Double-Opt-in für jeden Kanal.
Komponente aktualisieren
Ändert Name, Beschreibung, Gruppe, Position, Verfügbarkeitsbalken oder manuellen Zustand einer Komponente.