Schweregrad ändern

POST /api/im/incidents/:id/severity

Setzt den Schweregrad eines Incidents. Der Incident wird mit severityManual: true markiert, neue Alerts heben oder senken ihn also nicht mehr automatisch. Ist der Incident noch triggered, wird die anstehende Eskalation abgebrochen und mit dem neuen Schweregrad beim aktuellen Tier des Incidents neu scharf geschaltet. Statusseiten, die über eine Statusseiten-Regel gesteuert werden, und ausgehende Integrationen erfahren von der Änderung.

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. Anders als Lösen oder Statuswechsel hat dieser Einzel-Endpunkt keine Team-Einschränkung. (Die Aktion severity von Incidents gesammelt ändern schon.)

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

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

Antwort (Response)Ankerlink kopieren

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

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

(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
• 400 Bad Request (invalidRequestBody) wenn :id keine positive Ganzzahl ist, oder severity fehlt oder nicht sev1 bis sev4 ist
• 404 Not Found (imIncidentNotFound) wenn der Incident nicht existiert oder zu einer anderen Organisation gehört