---
title: "Design aktualisieren"
description: "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 |

### Header

| 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` | Eine Zeile „Powered by `<Ihr Produktname>`" im Footer anzeigen. Sie nennt den Produktnamen Ihrer Organisation und nie Uptimeify; ohne gesetzten Produktnamen wird nichts gerendert. |

## Beispiel: Dunkles Timeline-Layout

```bash
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

```bash
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

```json
{
  "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