---
title: "Incidents zusammenführen"
description: "Führt einen Incident-Management-Incident in einen anderen zusammen: seine Alerts und seine Timeline wandern mit, der zusammengeführte Incident eskaliert nicht weiter."
---

`POST /api/im/incidents/:id/merge`

Führt den Incident `:id` (die Quelle) in `targetIncidentId` zusammen, etwa wenn sich zwei Alerts als derselbe Ausfall herausstellen. In einem Schritt:

- alle Alerts und Timeline-Events der Quelle wandern zum Ziel,
- die Quelle erhält den Status `merged` und `mergedIntoId` zeigt auf das Ziel, ihre Eskalation endet,
- die Timeline der Quelle vermerkt `merged`, die des Ziels `merge_received`.

Rollen-Zuweisungen bleiben bei der Quelle. Über die API lässt sich ein Zusammenführen nicht rückgängig machen.

## Authentifizierung

Jede IM-berechtigte Rolle (`admin`, `editor`, `responder`) oder ein organisationsweiter API-Token, siehe [Authentifizierung](/de/api/incident-management#authentifizierung). Incident Management muss für die Organisation aktiviert sein.

Dem Team des Quell-Incidents vorbehalten: du musst Mitglied im Team von Incident `:id` oder Organisations-Admin sein. Ein organisationsweiter API-Token gilt dabei als Organisations-Admin.

## Anfrage (Request Body)

| Feld | Typ | Erforderlich | Beschreibung |
|-------|------|----------|--------------|
| `targetIncidentId` | number | Ja | Der Incident, in den zusammengeführt wird. Muss zur selben Organisation gehören und darf weder `merged` noch `resolved` sein. |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/im/incidents/43/merge" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "targetIncidentId": 42 }'
```

## Antwort (Response)

`200 OK`: der aktualisierte Quell-Incident (gleiche Form wie die `items` von [Incidents auflisten](/de/api/incident-management/list-incidents), ohne die Ergänzungsfelder) und die Ziel-ID.

```json
{
  "source": {
    "id": 43,
    "teamId": 3,
    "title": "Replica lag above threshold",
    "status": "merged",
    "mergedIntoId": 42,
    "currentTier": null,
    "escalationEpoch": 1
  },
  "targetIncidentId": 42
}
```

(`source` gekürzt; zurück kommt der vollständige Datensatz.)

## Häufige Fehler

- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` (`customerScopedTokenForbidden`) bei Verwendung eines kunden-gescopten Tokens
- `403 Forbidden` (`imAccessDenied`) wenn die angemeldete Person keine IM-berechtigte Rolle hat
- `403 Forbidden` (`imNotEnabled`) wenn Incident Management für die Organisation nicht aktiviert ist
- `403 Forbidden` (`imTeamMembershipRequired`) wenn du weder Mitglied im Team des Quell-Incidents noch Organisations-Admin bist
- `400 Bad Request` (`invalidRequestBody`) wenn `:id` keine positive Ganzzahl ist, oder `targetIncidentId` fehlt oder keine positive Ganzzahl ist
- `404 Not Found` (`imIncidentNotFound`) wenn Quell- oder Ziel-Incident nicht existiert oder zu einer anderen Organisation gehört
- `422 Unprocessable Entity` (`imIncidentCannotMergeIntoSelf`) wenn `targetIncidentId` gleich `:id` ist
- `422 Unprocessable Entity` (`imIncidentAlreadyMerged`) wenn der Quell-Incident bereits `merged` ist
- `422 Unprocessable Entity` (`imIncidentTargetAlreadyMerged`) wenn der Ziel-Incident `merged` ist
- `422 Unprocessable Entity` (`imMergeTargetClosed`) wenn der Ziel-Incident `resolved` ist