---
title: "Postmortem veröffentlichen"
description: "Veröffentlicht die Nachbetrachtung eines behobenen Vorfalls auf seinen Statusseiten, wahlweise mit einer Benachrichtigung an die Abonnenten."
---

`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](/de/api/monitoring/get-incident-details)). Sonst antwortet der Aufruf mit `409 postmortemIncidentNotResolved`.
- Mit `body` wird der Text zuerst gespeichert, im selben Aufruf. Ohne ihn wird der mit [Postmortem speichern](/de/api/monitoring/save-postmortem) 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.

## Authentifizierung

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>`

## Pfadparameter

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

## Request-Body

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

| Feld | Typ | Pflicht | Beschreibung |
|------|-----|---------|--------------|
| `body` | string | nein | Markdown, 1 bis 50.000 Zeichen. Wird vor dem Veröffentlichen gespeichert. |
| `notifySubscribers` | boolean | nein | Vorgabe `false`. `true` benachrichtigt die Abonnenten der Seiten einmal. |

Unbekannte Felder werden mit `400 invalidRequestBody` abgewiesen.

## Beispiel (cURL)

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

## Antwort

`200 OK`

```json
{
  "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](/de/api/status-pages/get-public-status-page)) trägt der Vorfall danach `postmortem: { body, publishedAt }`. Zurücknehmen mit [Postmortem zurücknehmen](/de/api/monitoring/unpublish-postmortem).

## Häufige Fehler

- `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