Offene Incidents zählen

GET /api/im/incidents/count

Liefert, wie viele Incidents offen und noch nicht bestätigt sind: Status weder resolved noch merged, und kein acknowledgedAt. Dazu zählen auch Incidents, die ohne Bestätigung direkt von triggered nach investigating, identified oder monitoring gewechselt sind. Test-Incidents (isTest: true) werden nie mitgezählt. Eine einzelne, günstige Zählung, gedacht zum regelmäßigen Abfragen für ein Badge oder ein Wallboard; für gefilterte Abfragen nimm Incidents auflisten.

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.

Beispiel (cURL)Ankerlink kopieren

curl -X GET "$BASE_URL/api/im/incidents/count" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)Ankerlink kopieren

{
  "count": 4
}

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