---
title: "Teams"
description: "Listet die Incident-Management-Teams deiner Organisation, mit Mitgliederzahl pro Team."
---

`GET /api/im/teams`

Ein **Team** ist die oberste Besitz-Einheit in Incident Management: Jeder [Schedule](./schedules), 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)

```bash
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.

```json
[
  {
    "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