Sofort eskalieren

POST /api/im/incidents/:id/escalate-now

Alarmiert den nächsten Eskalations-Tier des Teams sofort, statt auf das Timeout des aktuellen Tiers zu warten. Nur gültig, solange der Incident triggered ist (also noch eskaliert). Die anstehenden Jobs des aktuellen Tiers werden abgebrochen und der nächste Tier (die niedrigste Tier-Reihenfolge über der aktuellen) wird sofort scharf geschaltet. Den Tier-Wechsel selbst trägt die Eskalations-Engine einen Moment später ein, currentTier in der Antwort zeigt also noch den Tier, von dem aus du eskaliert hast.

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 Incidents vorbehalten: du musst Mitglied im Team des Incidents (teamId) oder Organisations-Admin sein. Ein organisationsweiter API-Token gilt dabei als Organisations-Admin.

Kein Request-Body.

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/im/incidents/42/escalate-now" \
  -H "Authorization: Bearer $TOKEN"

Antwort (Response)Ankerlink kopieren

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

{
  "id": 42,
  "teamId": 3,
  "title": "Database connection pool exhausted",
  "severity": "sev1",
  "status": "triggered",
  "currentTier": 1,
  "escalationEpoch": 3
}

(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 Incidents noch Organisations-Admin bist
• 400 Bad Request (invalidRequestBody) wenn :id keine positive Ganzzahl ist
• 404 Not Found (imIncidentNotFound) wenn der Incident nicht existiert oder zu einer anderen Organisation gehört
• 422 Unprocessable Entity (imIncidentNotEscalating) wenn der Incident nicht triggered ist
• 422 Unprocessable Entity (imNoFurtherTier) wenn das Team keinen Tier über dem aktuellen hat
• 409 Conflict (imIncidentStatusConflict) wenn sich der Eskalationszustand gleichzeitig geändert hat, sicher wiederholbar