Teams

GET /api/im/teams

Ein Team ist die oberste Besitz-Einheit in Incident Management: Jeder Schedule, jede Eskalationsrichtlinie und jeder Incident gehört zu genau einem Team. Dieser Endpunkt listet die Teams deiner Organisation. Schreibende Operationen auf Teams und Mitgliedschaften (Team anlegen, Mitglieder einladen/entfernen) werden heute im Dashboard verwaltet und sind noch nicht Teil der dokumentierten Oberfläche dieser öffentlichen API.

Authentifizierung

Erfordert den Basis-IM-Zugriff, den jeder Endpunkt dieser API benötigt: eine IM-berechtigte Rolle (admin, editor oder responder), oder einen organisationsweiten API-Token. Incident Management muss für die Organisation aktiviert sein.

Beispiel (cURL)

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

Antwort (Response)

200 OK: ein Array, sortiert nach Name.

[
  {
    "id": 3,
    "name": "Platform Team",
    "labelColor": "#4f46e5",
    "analyticsEnabled": true,
    "memberCount": 5
  }
]

Häufige Fehler

• 401 Unauthorized wenn du nicht authentifiziert bist
• 403 Forbidden (imAccessDenied) bei Verwendung eines kunden-gescopten Tokens, oder wenn deine Session keine IM-berechtigte Rolle hat
• 403 Forbidden (imNotEnabled) wenn Incident Management für die Organisation nicht aktiviert ist