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.

PATCH /api/status-pages/:id/design

Pfad-Parameter

Parameter	Beschreibung
`id`	Status-Seiten-ID oder `publicId` (UUID)

Request Body (alle Felder optional)

Layout

Feld	Typ	Werte	Standard	Beschreibung
`layout`	string	`classic` `cards` `minimal` `sleek` `board` `split` `timeline` `compact`	`classic`	Visuelles Layout-Template
`pageWidth`	string	`sm` `md` `lg` `xl`	`lg`	Maximale Inhaltsbreite: sm = 672 px, md = 896 px, lg = 1024 px, xl = 1280 px

Farben

Feld	Typ	Werte	Standard	Beschreibung
`colorScheme`	string	`light` `dark` `auto`	`auto`	Farbmodus. `auto` folgt der Systemeinstellung des Besuchers.
`accentColor`	string	Hex, z. B. `#6366f1`	`#6366f1`	Akzentfarbe für Highlights, Rahmen und Verläufe

Typografie & Stil

Feld	Typ	Werte	Standard	Beschreibung
`fontFamily`	string	`system` `mono`	`system`	`system` = Standard-Serifenloser, `mono` = Monospace
`cardRadius`	string	`none` `md` `xl`	`md`	Abrundung der Karten: none = eckig, md = abgerundet, xl = stark abgerundet

Feld	Typ	Werte	Standard	Beschreibung
`headerStyle`	string	`simple` `centered` `hero`	`simple`	`simple` = linksbündig, `centered` = zentriert, `hero` = breites Gradient-Banner
`customTitle`	string	max. 120 Zeichen	`""`	Überschreibt den Seitennamen im Header. Leer lassen, um den Seitennamen zu verwenden.
`customSubtitle`	string	max. 200 Zeichen	`""`	Optionaler Untertitel unterhalb des Titels

Anzeigeoptionen

Feld	Typ	Standard	Beschreibung
`showUptimeStats`	boolean	`true`	Verfügbarkeitsprozent und Dienst-Übersicht anzeigen
`showServiceUrls`	boolean	`false`	Überwachte URL unterhalb des Dienstnamens anzeigen
`showLastChecked`	boolean	`false`	Zeitstempel der letzten Prüfung je Dienst anzeigen
`showHistory`	boolean	`true`	Bereich für vergangene Vorfälle & Wartungsfenster anzeigen
`showPoweredBy`	boolean	`true`	„Powered by …"-Badge im Footer anzeigen

Beispiel – Dunkles Timeline-Layout

curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "layout": "timeline",
    "colorScheme": "dark",
    "accentColor": "#f59e0b",
    "pageWidth": "lg"
  }'

Beispiel – Minimalistisch, kein Branding, volle Breite

curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "layout": "minimal",
    "colorScheme": "light",
    "pageWidth": "xl",
    "showPoweredBy": false,
    "showUptimeStats": false,
    "customTitle": "System-Status",
    "customSubtitle": "Live-Übersicht aller Dienste"
  }'

Antwort

{
  "designConfig": {
    "layout": "timeline",
    "colorScheme": "dark",
    "accentColor": "#f59e0b",
    "headerStyle": "simple",
    "fontFamily": "system",
    "cardRadius": "md",
    "pageWidth": "lg",
    "customTitle": "",
    "customSubtitle": "",
    "showPoweredBy": true,
    "showUptimeStats": true,
    "showServiceUrls": false,
    "showLastChecked": false,
    "showHistory": true
  }
}

Fehler

400 Bad Request – ungültiger Feldwert (z. B. unbekannter Layout-Name oder falsches Hex-Farb-Format)
401 Unauthorized – nicht angemeldet
403 Forbidden – keine Admin-Rechte
404 Not found – Status-Seite nicht gefunden

Design aktualisieren

Auf dieser Seite