Postmortem veröffentlichen

POST /api/incidents/:id/postmortem/publish

Veröffentlicht die Nachbetrachtung eines Vorfalls. Sie erscheint dann unter dem Vorfall auf jeder Statusseite, die ihn zeigt, in jedem Layout als aufklappbarer Abschnitt. Dasselbe tun „Veröffentlichen“ in der Karte „Nachbetrachtung“ des Statusseiten-Moduls und das MCP-Tool publish_postmortem.

• Nur ein behobener Vorfall bekommt eine veröffentlichte Nachbetrachtung: behoben auf den Statusseiten (publicStatus, siehe Ausfall-Details abrufen). Sonst antwortet der Aufruf mit 409 postmortemIncidentNotResolved.
• Mit body wird der Text zuerst gespeichert, im selben Aufruf. Ohne ihn wird der mit Postmortem speichern gespeicherte Text veröffentlicht; ohne gespeicherten Text antwortet der Aufruf mit 404 postmortemNotFound.
• Mit notifySubscribers: true bekommen die Abonnenten dieser Seiten eine Benachrichtigung postmortem_published (E-Mail, Webhook, Slack, Teams), nach der Abo-Verzögerung der Seite. Wird die Nachbetrachtung vorher zurückgenommen, geht nichts raus.
• Wiederholungen: Eine schon veröffentlichte Nachbetrachtung bleibt veröffentlicht und antwortet mit 200 OK. Ein body ersetzt ihren Text; eine zweite Benachrichtigung gibt es nicht.

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

Optional; ein leerer Body veröffentlicht den gespeicherten Text ohne Benachrichtigung.

Unbekannte Felder werden mit 400 invalidRequestBody abgewiesen.

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/incidents/5121/postmortem/publish" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "notifySubscribers": true }'

AntwortAnkerlink kopieren

200 OK

{
  "incidentId": 5121,
  "incidentPublicId": "8a3c1f6e-2b7d-4e59-9c1a-5d2e7f0b4c33",
  "body": "## Ursache\nEinem Datenbankknoten ging der Speicherplatz aus.",
  "publishedAt": "2026-10-28T14:05:40.000Z",
  "updatedAt": "2026-10-28T14:02:11.000Z"
}

Auf der öffentlichen Statusseite (Öffentliche Status-Seite abfragen) trägt der Vorfall danach postmortem: { body, publishedAt }. Zurücknehmen mit Postmortem zurücknehmen.

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidRequestBody), wenn body leer oder länger als 50.000 Zeichen ist, ein Feld den falschen Typ hat oder ein unbekanntes Feld mitkommt
• 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
• 404 Not Found (postmortemNotFound), wenn kein Text gespeichert ist und kein body mitkommt
• 409 Conflict (postmortemIncidentNotResolved), wenn der Vorfall auf den Statusseiten nicht behoben ist