---
title: "Status-Seite aktualisieren"
description: "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](./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)

```bash
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
- `403 Forbidden`, wenn kein Admin
- `404 Not found`, wenn die Status-Seite nicht existiert
- `409 Conflict`, wenn der Slug bereits vergeben ist

## Antwort (Response)

Gibt das aktualisierte Status-Seiten-Objekt zurück. Siehe [Fehlerliste](/de/api/error-codes-and-known-pitfalls) für Fehlerantworten.
