Postmortem speichern

PUT /api/incidents/:id/postmortem

Speichert die öffentliche Nachbetrachtung (Postmortem) eines Vorfalls: was passiert ist, warum, und was geändert wurde, in Markdown. Wie bei Atlassian Statuspage erscheint sie unter dem Vorfall auf jeder Statusseite, die den Vorfall zeigt, sobald sie mit Postmortem veröffentlichen veröffentlicht ist. Bis dahin ist sie ein Entwurf, nur im Statusseiten-Modul sichtbar.

Ein Vorfall hat höchstens eine Nachbetrachtung; dieser Aufruf legt sie an oder ersetzt ihren Text. Bei einer veröffentlichten Nachbetrachtung ist der neue Text sofort sichtbar, sie bleibt veröffentlicht. Speichern verschickt keine Benachrichtigung. Gespeichert werden kann jederzeit, veröffentlicht nur bei einem behobenen Vorfall.

Die Statusseiten zeichnen das Markdown selbst und nie als rohes HTML: Überschriften, Absätze, Listen, fett, kursiv, Code und Links auf http(s)-Adressen. Alles andere, auch HTML-Tags, erscheint als einfacher Text.

AuthentifizierungAnkerlink kopieren

Erfordert die Rolle admin oder editor im Kundenbereich des Vorfalls. Ein Vorfall ohne Kunde braucht eine organisationsweite Rolle oder ein solches Token; für jede andere Organisation antwortet er mit 404 incidentNotFound. readonly bekommt 403 forbidden.

• Header: Authorization: Bearer <token>

PfadparameterAnkerlink kopieren

• id (erforderlich): numerische ID oder publicId (UUID) des Vorfalls.

Request-BodyAnkerlink kopieren

Unbekannte Felder werden mit 400 invalidRequestBody abgewiesen.

Beispiel (cURL)Ankerlink kopieren

curl -X PUT "$BASE_URL/api/incidents/5121/postmortem" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "## Ursache\nEinem Datenbankknoten ging der Speicherplatz aus.\n\n## Maßnahmen\n- Alarm ab 80 % Plattenbelegung" }'

AntwortAnkerlink kopieren

200 OK

{
  "incidentId": 5121,
  "incidentPublicId": "8a3c1f6e-2b7d-4e59-9c1a-5d2e7f0b4c33",
  "body": "## Ursache\nEinem Datenbankknoten ging der Speicherplatz aus.\n\n## Maßnahmen\n- Alarm ab 80 % Plattenbelegung",
  "publishedAt": null,
  "updatedAt": "2026-10-28T14:02:11.000Z"
}

Ausfall-Details abrufen liefert dieselben Felder als postmortem.

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidRequestBody), wenn body fehlt, leer oder länger als 50.000 Zeichen ist oder ein unbekanntes Feld mitkommt
• 400 Bad Request (incidentNoCustomer), wenn der Vorfall weder einen Kunden noch eine Statusseite hat
• 401 Unauthorized, wenn nicht angemeldet
• 403 Forbidden (forbidden), wenn deine Rolle oder dein Kundenbereich es nicht erlaubt
• 404 Not Found (incidentNotFound), wenn der Vorfall in deiner Organisation nicht existiert