Status-Seite aktualisieren
Aktualisiert eine Status-Seite. Mindestens ein Feld muss angegeben werden. Erfordert Admin-Rolle.
PATCH /api/status-pages/:id
Request-Body (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
customerId | number | Status-Seite zu einem anderen Kunden verschieben |
name | string | Anzeigename (1-120 Zeichen) |
slug | string | URL-Slug (1-120 Zeichen, 409 bei Konflikt) |
description | string|null | Beschreibung (max. 1000 Zeichen). null löscht sie. |
visibility | string | public oder customer_members_only |
isPublished | boolean | Seite veröffentlichen oder verbergen |
showRecentIncidents | boolean | Abschnitt „Letzte Vorfälle" anzeigen |
showRecentMaintenance | boolean | Abschnitt „Letzte Wartungen" anzeigen |
designConfig | object | Visuelle Design-Einstellungen (Layout, Farben, Typografie, …). Alle Felder siehe Design aktualisieren. |
hiddenMonitors | array | Monitore, die auf dieser Statusseite ausgeblendet werden. Jeder Eintrag ist { "type": "http"|"dns"|"icmp"|"smtp"|"ssh"|"ftp"|"imap_pop", "id": <Monitor-ID> }. Leer lassen oder [] senden, um alle Monitore anzuzeigen (Standard). Später hinzugefügte Monitore erscheinen automatisch. Maximal 500 Einträge. |
Wenn angegeben, ersetzt hiddenMonitors die gespeicherte Liste vollständig; ohne das Feld bleibt sie unverändert; [] zeigt wieder alle Monitore an.
Beispiel (cURL)
curl -X PATCH "$BASE_URL/api/status-pages/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Production Status - Updated",
"isPublished": true,
"showRecentIncidents": true,
"hiddenMonitors": [{ "type": "http", "id": 42 }]
}'Häufige Fehler
401 Unauthorized, wenn nicht authentifiziert403 Forbidden, wenn kein Admin404 Not found, wenn die Status-Seite nicht existiert409 Conflict, wenn der Slug bereits vergeben ist
Antwort (Response)
Gibt das aktualisierte Status-Seiten-Objekt zurück. Siehe Fehlerliste für Fehlerantworten.
Design aktualisieren
Aktualisiert die visuelle Designkonfiguration einer Status-Seite. Es werden nur die übermittelten Felder geändert. Alle anderen Einstellungen bleiben unverändert. Erfordert Admin-Rolle.
Status-Seiten-Domain verifizieren
Verifiziert die DNS-TXT-Einträge einer eigenen Status-Seiten-Domain. Nur Admin.