---
title: "Postmortem speichern"
description: "Speichert die öffentliche Nachbetrachtung (Markdown) eines Vorfalls als Entwurf oder ersetzt den Text einer veröffentlichten."
---

`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](/de/api/monitoring/publish-postmortem) 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.

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

| Feld | Typ | Pflicht | Beschreibung |
|------|-----|---------|--------------|
| `body` | string | ja | Markdown, nach dem Trimmen 1 bis 50.000 Zeichen. |

Unbekannte Felder werden mit `400 invalidRequestBody` abgewiesen.

## Beispiel (cURL)

```bash
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" }'
```

## Antwort

`200 OK`

```json
{
  "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"
}
```

| Feld | Beschreibung |
|------|--------------|
| `publishedAt` | `null` = Entwurf; sonst der Zeitpunkt der Veröffentlichung (ISO 8601). |
| `updatedAt` | Wann der Text zuletzt gespeichert wurde. |

[Ausfall-Details abrufen](/de/api/monitoring/get-incident-details) liefert dieselben Felder als `postmortem`.

## Häufige Fehler

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