Incident schlummern lassen

POST /api/im/incidents/:id/snooze

Pausiert Eskalation und Erinnerungen eines offenen Incidents bis snoozedUntil. Anstehende Eskalations-Jobs werden abgebrochen, die Alarmierung läuft nach Ablauf automatisch weiter. Mit null (oder ohne das Feld) endet das Schlummern sofort: ein triggered-Incident eskaliert dann gleich ab seinem aktuellen Tier weiter. Jeder Aufruf wird in der Timeline des Incidents vermerkt.

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.

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/im/incidents/42/snooze" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "snoozedUntil": "2026-07-17T13:00:00.000Z" }'

Schlummern vorzeitig beenden:

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

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": 2,
  "snoozedUntil": "2026-07-17T13:00:00.000Z"
}

(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, oder snoozedUntil kein gültiger Zeitpunkt ist
• 400 Bad Request (imSnoozeRangeInvalid) wenn snoozedUntil nicht in der Zukunft oder mehr als 7 Tage voraus liegt
• 404 Not Found (imIncidentNotFound) wenn der Incident nicht existiert oder zu einer anderen Organisation gehört
• 422 Unprocessable Entity (imIncidentClosed) wenn der Incident resolved oder merged ist