Incidents zusammenführen

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.

AuthentifizierungAnkerlink kopieren

Jede IM-berechtigte Rolle (admin, editor, responder) oder ein organisationsweiter API-Token, siehe 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)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

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

Antwort (Response)Ankerlink kopieren

200 OK: der aktualisierte Quell-Incident (gleiche Form wie die items von Incidents auflisten, ohne die Ergänzungsfelder) und die Ziel-ID.

{
  "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 FehlerAnkerlink kopieren

• 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