Statusseite aktualisieren
Aktualisiert eine Statusseite. Mindestens ein Feld muss angegeben werden. Erfordert die Rolle `admin` oder `editor`; kundengebundene Nutzer und Tokens (auch `readonly`) ändern selbstverwaltete Seiten ihrer Kunden.
PATCH /api/status-pages/:id
Request-Body (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
customerId | number|null | Seite zu einem anderen Kunden deiner Organisation verschieben. null löst sie von ihrem Kunden (Seite der ganzen Organisation); das dürfen nur organisationsweite Rollen und API-Token. |
includeCustomerMonitors | boolean | Jeden Monitor des Kunden, außer denen in hiddenMonitors, automatisch hinter den ausdrücklichen Komponenten anzeigen. Ein Wechsel von customerId lässt den Wert unverändert. |
managementType | string | managed oder self_service. Ändern dürfen nur Organisations-Admins ohne Kundenbindung (sonst 403 managementTypeOrgOnly). |
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, customer_members_only, password_protected (jeder mit dem Seitenpasswort, siehe unten) oder sso_members_only (wie customer_members_only, zusätzlich muss die Sitzung über das Single Sign-on deiner Organisation entstanden sein) |
accessPassword | string | Setzt ein neues Seitenpasswort (8-200 Zeichen). Pflicht, wenn die Seite password_protected wird und noch kein Passwort hat; sonst lässt du das Feld weg und das bisherige bleibt. Ein neues Passwort meldet jeden Besucher ab, der die Seite freigeschaltet hat. Entfernen lässt sich das Passwort nicht: Wechselst du auf eine andere Sichtbarkeit, bleibt es gespeichert (hasPassword bleibt true), und beim Zurückwechseln gilt es wieder. Wird nie zurückgegeben; die Antwort zeigt hasPassword und accessPasswordSetAt. |
ipAllowlist | array | Ersetzt die IP-Freigabeliste: IPv4-/IPv6-Adressen oder CIDR-Bereiche, höchstens 50, gespeichert als addr/prefix. [] hebt die Beschränkung auf. |
audienceGroups | array | Ersetzt alle Zielgruppen, höchstens 20: [{ "name", "emailDomains", "componentIds" }]. [] entfernt sie. Siehe unten. |
isPublished | boolean | Seite veröffentlichen oder verbergen |
showRecentIncidents | boolean | Abschnitt „Letzte Vorfälle" anzeigen |
showRecentMaintenance | boolean | Abschnitt „Letzte Wartungen" anzeigen |
smsSubscriptionsEnabled | boolean | SMS-Abos auf der öffentlichen Seite anbieten (Standard false). Ausschalten stoppt auch die SMS an bestehende SMS-Abonnenten. Einschalten braucht SMS-Kontingent (sonst 403 smsQuotaRequired); eine Seite, die es schon an hat, behält es. |
pushSubscriptionsEnabled | boolean | Browser-Push-Abos auf der öffentlichen Seite anbieten (Standard false). Ausschalten stoppt auch den Push an bestehende Push-Abonnenten. |
monitorUpdatesEnabled | boolean | Monitore schreiben auf diese Seite (Standard true): ihr Zustand setzt Komponenten und Seitenstatus, Monitoring-Vorfälle stehen in der Historie und gehen an die Abonnenten. false: die Seite zeigt nur, was ihr meldet oder ausdrücklich verknüpft (verknüpfte Vorfälle, Wartungen, Regeln aus Incident Management). |
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.
Private Seiten (seit 28. Oktober 2026).
password_protected: Wer das Seitenpasswort kennt, sieht die Seite. Besucher schalten sie über den verify-password-Endpunkt frei, der ein Zugriffs-Cookie für 30 Tage setzt; ohne dieses Cookie antwortet die öffentliche Seite401 passwordRequired. Beim Wechsel aufpassword_protectedbrauchst duaccessPasswordnur, solange die Seite noch kein gespeichertes Passwort hat (hasPassword: false); sonst wird die Anfrage mit400 passwordRequiredabgewiesen.sso_members_only: wiecustomer_members_only(angemeldete Mitglieder des Kunden, bei einer Seite ohne Kunde der Organisation), zusätzlich muss die Sitzung über das Single Sign-on deiner Organisation (OIDC oder SAML) entstanden sein. Ohne Anmeldung oder mit einer Anmeldung ohne SSO antwortet die öffentliche Seite401 ssoRequired. Solange deine Organisation kein bestätigtes SSO hat, wird der Wert mit400 ssoNotConfiguredabgewiesen.ipAllowlistgilt zusätzlich zu jeder Sichtbarkeit: Besucher aus anderen Netzen bekommen403 statusPageIpNotAllowed. Maßgeblich ist die Adresse, die unser Reverse Proxy sieht; ein vom Client mitgeschickterX-Forwarded-For-Header zählt nicht. Ein ungültiger Eintrag wird mit400(invalidRequestBody) abgewiesen.audienceGroups(nur per PATCH): Jede Gruppe hat einenname(1-80 Zeichen),emailDomains(1-20 Domains, klein geschrieben gespeichert) undcomponentIds(1-100 Komponenten dieser Seite, numerische ID oderpublicId; gespeichert als numerische IDs). Eine Komponente, die in einer Gruppe steht, zeigt die öffentliche Seite nur Besuchern, die mit einer bestätigten E-Mail-Adresse einer Domain dieser Gruppe angemeldet sind (genau diese Domain, Subdomains zählen nicht), sowie Admins und Editoren der Seite. Komponenten ohne Gruppe sieht jeder, der die Seite sehen darf. Vorfälle und Wartungen, die nur ausgeblendete Komponenten betreffen, fallen für diesen Besucher ebenfalls weg, und der Gesamtstatus ergibt sich aus dem, was er sieht.- Wenn angegeben, ersetzen
ipAllowlistundaudienceGroupsden gespeicherten Wert vollständig. - Eine Seite mit
ipAllowlistoderaudienceGroupshat, wie jede Seite mit einer anderen Sichtbarkeit alspublic, kein Badge, kein Embed-Widget, keine Atom-/RSS-Feeds und nimmt keine Abos an (diese Adressen antworten404wie eine fehlende Seite). Bestehende Abonnenten einer solchen Seite bekommen keine Benachrichtigungen mehr.
Ein Wechsel zu einem anderen Kunden wird mit 400 (statusPageComponentMonitorCustomerMismatch) abgewiesen, solange die Seite Monitor-Komponenten eines anderen Kunden hat; lösche diese Komponenten vorher. Die Komponenten selbst verwaltest du über die Komponenten-Endpunkte.
Kompatibilität: Seit dem 27.10.2026 kann customerId in Antworten null sein (eine Seite der ganzen Organisation, ohne Kunde), ebenso customerPublicId und customerName, wo vorhanden. Ein Client, der annimmt, dass customerId immer eine Zahl ist, muss null behandeln.
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 authentifiziert400 Bad Request(statusPageComponentMonitorCustomerMismatch), wenn dem neuen Kunden nicht alle Monitor-Komponenten der Seite gehören403 Forbidden(forbidden), wenn ein organisationsweiter Aufrufer weder die Rolleadminnocheditorhat, oder für einen Global Supporter403 Forbidden(forbidden), wenn ein kundengebundenerreadonly-Nutzer oder ein von ihm ausgestellter TokendesignConfig,showRecentIncidentsodershowRecentMaintenanceschickt: das Design verlangt die Rolleadminodereditor403 Forbidden(managed_by_organization), wenn ein kundengebundener Nutzer oder Token einemanaged-Seite ohne die AusnahmecanEditManageddes Kunden ändert403 Forbidden(managementTypeOrgOnly), wenn jemand anderes als ein Organisations-Admin ohne KundenbindungmanagementTypeändert403 Forbidden(smsQuotaRequired), wennsmsSubscriptionsEnabledeingeschaltet wird und deine Organisation gerade keine SMS senden kann (kein Inklusivvolumen mehr, Mehrnutzung aus oder SMS-Deckel erreicht)409 Conflict(statusPageLimitReached, mitdata.max), wenncustomerIddie Seite zu einem Kunden umhängt, dessen Paket keine weiteren Statusseiten erlaubt403 Forbidden(forbidden), wenn ein kundengebundener Nutzer oder Token eine Seite ohne Kunde ändert,customerId: nullsendet oder einen Kunden außerhalb seines Bereichs nennt404 Not Found(customerNotFound), wenncustomerIdkein Kunde deiner Organisation ist404 Not found, wenn die Statusseite nicht existiert409 Conflict, wenn der Slug bereits vergeben ist400 Bad Request(passwordRequired), wenn die Seitepassword_protectedist oder wird, kein gespeichertes Passwort hat undaccessPasswordfehlt400 Bad Request(invalidRequestBody), wennaccessPasswordkürzer als 8 oder länger als 200 Zeichen ist400 Bad Request(ssoNotConfigured), wennvisibilityaufsso_members_onlywechselt und deine Organisation kein bestätigtes Single Sign-on hat400 Bad Request(invalidRequestBody), wenn ein Eintrag inipAllowlistkeine IPv4-/IPv6-Adresse und kein CIDR-Bereich ist oderipAllowlistbzw.audienceGroupsihre Grenzen überschreiten400 Bad Request(statusPageComponentNotFound), wenn ein Eintrag inaudienceGroupseine Komponente nennt, die nicht auf dieser Seite liegt
Antwort (Response)
Gibt das aktualisierte Statusseiten-Objekt zurück. Siehe Fehlerliste für Fehlerantworten.