Skip to Content
Uptimeify Docs

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)

FeldTypBeschreibung
customerIdnumber|nullSeite 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.
includeCustomerMonitorsbooleanJeden 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.
managementTypestringmanaged oder self_service. Ändern dürfen nur Organisations-Admins ohne Kundenbindung (sonst 403 managementTypeOrgOnly).
namestringAnzeigename (1-120 Zeichen)
slugstringURL-Slug (1-120 Zeichen, 409 bei Konflikt)
descriptionstring|nullBeschreibung (max. 1000 Zeichen). null löscht sie.
visibilitystringpublic, 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)
accessPasswordstringSetzt 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.
ipAllowlistarrayErsetzt die IP-Freigabeliste: IPv4-/IPv6-Adressen oder CIDR-Bereiche, höchstens 50, gespeichert als addr/prefix. [] hebt die Beschränkung auf.
audienceGroupsarrayErsetzt alle Zielgruppen, höchstens 20: [{ "name", "emailDomains", "componentIds" }]. [] entfernt sie. Siehe unten.
isPublishedbooleanSeite veröffentlichen oder verbergen
showRecentIncidentsbooleanAbschnitt „Letzte Vorfälle" anzeigen
showRecentMaintenancebooleanAbschnitt „Letzte Wartungen" anzeigen
smsSubscriptionsEnabledbooleanSMS-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.
pushSubscriptionsEnabledbooleanBrowser-Push-Abos auf der öffentlichen Seite anbieten (Standard false). Ausschalten stoppt auch den Push an bestehende Push-Abonnenten.
monitorUpdatesEnabledbooleanMonitore 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).
designConfigobjectVisuelle Design-Einstellungen (Layout, Farben, Typografie, …). Alle Felder siehe Design aktualisieren.
hiddenMonitorsarrayMonitore, 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 Seite 401 passwordRequired. Beim Wechsel auf password_protected brauchst du accessPassword nur, solange die Seite noch kein gespeichertes Passwort hat (hasPassword: false); sonst wird die Anfrage mit 400 passwordRequired abgewiesen.
  • sso_members_only: wie customer_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 Seite 401 ssoRequired. Solange deine Organisation kein bestätigtes SSO hat, wird der Wert mit 400 ssoNotConfigured abgewiesen.
  • ipAllowlist gilt zusätzlich zu jeder Sichtbarkeit: Besucher aus anderen Netzen bekommen 403 statusPageIpNotAllowed. Maßgeblich ist die Adresse, die unser Reverse Proxy sieht; ein vom Client mitgeschickter X-Forwarded-For-Header zählt nicht. Ein ungültiger Eintrag wird mit 400 (invalidRequestBody) abgewiesen.
  • audienceGroups (nur per PATCH): Jede Gruppe hat einen name (1-80 Zeichen), emailDomains (1-20 Domains, klein geschrieben gespeichert) und componentIds (1-100 Komponenten dieser Seite, numerische ID oder publicId; 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 ipAllowlist und audienceGroups den gespeicherten Wert vollständig.
  • Eine Seite mit ipAllowlist oder audienceGroups hat, wie jede Seite mit einer anderen Sichtbarkeit als public, kein Badge, kein Embed-Widget, keine Atom-/RSS-Feeds und nimmt keine Abos an (diese Adressen antworten 404 wie 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 authentifiziert
  • 400 Bad Request (statusPageComponentMonitorCustomerMismatch), wenn dem neuen Kunden nicht alle Monitor-Komponenten der Seite gehören
  • 403 Forbidden (forbidden), wenn ein organisationsweiter Aufrufer weder die Rolle admin noch editor hat, oder für einen Global Supporter
  • 403 Forbidden (forbidden), wenn ein kundengebundener readonly-Nutzer oder ein von ihm ausgestellter Token designConfig, showRecentIncidents oder showRecentMaintenance schickt: das Design verlangt die Rolle admin oder editor
  • 403 Forbidden (managed_by_organization), wenn ein kundengebundener Nutzer oder Token eine managed-Seite ohne die Ausnahme canEditManaged des Kunden ändert
  • 403 Forbidden (managementTypeOrgOnly), wenn jemand anderes als ein Organisations-Admin ohne Kundenbindung managementType ändert
  • 403 Forbidden (smsQuotaRequired), wenn smsSubscriptionsEnabled eingeschaltet wird und deine Organisation gerade keine SMS senden kann (kein Inklusivvolumen mehr, Mehrnutzung aus oder SMS-Deckel erreicht)
  • 409 Conflict (statusPageLimitReached, mit data.max), wenn customerId die Seite zu einem Kunden umhängt, dessen Paket keine weiteren Statusseiten erlaubt
  • 403 Forbidden (forbidden), wenn ein kundengebundener Nutzer oder Token eine Seite ohne Kunde ändert, customerId: null sendet oder einen Kunden außerhalb seines Bereichs nennt
  • 404 Not Found (customerNotFound), wenn customerId kein Kunde deiner Organisation ist
  • 404 Not found, wenn die Statusseite nicht existiert
  • 409 Conflict, wenn der Slug bereits vergeben ist
  • 400 Bad Request (passwordRequired), wenn die Seite password_protected ist oder wird, kein gespeichertes Passwort hat und accessPassword fehlt
  • 400 Bad Request (invalidRequestBody), wenn accessPassword kürzer als 8 oder länger als 200 Zeichen ist
  • 400 Bad Request (ssoNotConfigured), wenn visibility auf sso_members_only wechselt und deine Organisation kein bestätigtes Single Sign-on hat
  • 400 Bad Request (invalidRequestBody), wenn ein Eintrag in ipAllowlist keine IPv4-/IPv6-Adresse und kein CIDR-Bereich ist oder ipAllowlist bzw. audienceGroups ihre Grenzen überschreiten
  • 400 Bad Request (statusPageComponentNotFound), wenn ein Eintrag in audienceGroups eine Komponente nennt, die nicht auf dieser Seite liegt

Antwort (Response)

Gibt das aktualisierte Statusseiten-Objekt zurück. Siehe Fehlerliste für Fehlerantworten.

Auf dieser Seite