Vorfall aktualisieren

Ä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. `[]` 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)

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

Antwort (Response)

200 OK

{ "ok": true }

Vorfall-Details abrufen 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

Vorfall aktualisieren

AuthentifizierungAnkerlink kopieren

PfadparameterAnkerlink kopieren

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

Antwort (Response)Ankerlink kopieren

Häufige FehlerAnkerlink kopieren