---
title: "Vorfall aktualisieren"
description: "Ändert Überschrift, Schweregrad, Status und die verknüpften Statusseiten und Komponenten eines Vorfalls."
---

`PATCH /api/incidents/:id`

Ändert einen manuellen oder Monitor-Vorfall: Überschrift, Zusammenfassung, Schweregrad, Status und seit dem 27. Oktober 2026 die Statusseiten und Komponenten, mit denen er verknüpft ist. Weggelassene Felder bleiben unverändert.

Beheben (`status: resolved`) oder Wiedereröffnen benachrichtigt die Abonnenten jeder Seite, auf der der Vorfall erscheint, auch der verknüpften.

## Authentifizierung

Erfordert die Rolle `admin` oder `editor` im Kundenbereich des Vorfalls. Ein Vorfall ohne Kunden braucht eine organisationsweite Rolle oder einen solchen Token; für jede andere Organisation antwortet er mit `404 incidentNotFound`.

- Header: `Authorization: Bearer <token>`

## Pfadparameter

- `id` (Pflicht): numerische id oder `publicId` (UUID).

## Anfrage (Request Body)

| Feld | Typ | Beschreibung |
|-------|------|-------------|
| `status` | string | `open`, `acknowledged` oder `resolved`. |
| `severity` | string | `minor`, `major`, `critical` oder `maintenance`. |
| `title` | string | 1 bis 200 Zeichen. |
| `summary` | string oder null | Bis zu 5.000 Zeichen, `null` leert sie. |
| `statusPageIds` | Array | Ersetzt die verknüpften Seiten (id oder publicId). Gleiche Regeln wie bei [Manuellen Vorfall anlegen](/de/api/monitoring/create-manual-incident). `[]` entfernt jede Verknüpfung, was ein Vorfall ohne Kunden nicht kann (`400 incidentTargetRequired`). |
| `componentIds` | Array | Ersetzt die verknüpften Komponenten, zusammen mit `statusPageIds`. |
| `impact` | string | Mit `statusPageIds`: die Auswirkung der neuen Verknüpfungen. Allein: setzt die Auswirkung aller bestehenden Verknüpfungen. |

## Beispiel (cURL)

```bash
curl -X PATCH "$BASE_URL/api/incidents/5121" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "impact": "degraded" }'
```

## Antwort (Response)

`200 OK`

```json
{ "ok": true }
```

[Vorfall-Details abrufen](/de/api/monitoring/get-incident-details) liefert die Verknüpfungen als `statusPageLinks`.

## Häufige Fehler

- `400 Bad Request` (`invalidRequestBody`), wenn der Body leer ist oder ein Feld Typ oder Wert falsch hat
- `400 Bad Request` (`incidentTargetRequired`, `statusPageIdsRequired`, `statusPageComponentNotOnPage`, `statusPageCustomerMismatch`) wie beim Anlegen
- `401 Unauthorized`, wenn Sie nicht authentifiziert sind
- `403 Forbidden` (`forbidden`), wenn Rolle oder Kundenbereich die Änderung nicht erlauben
- `403 Forbidden` (`statusPagesModuleDisabled`), wenn `statusPageIds` nicht leer ist und das Statusseiten-Modul für Ihre Organisation nicht aktiviert ist; Vorfälle ohne Statusseiten sind nicht betroffen
- `404 Not Found` (`incidentNotFound`, `statusPageNotFound`, `statusPageComponentNotFound`), wenn Vorfall, Seite oder Komponente in Ihrer Organisation nicht existieren