Teams

GET /api/im/teams

A team is the top-level ownership unit in Incident Management: every schedule, escalation policy, and incident belongs to exactly one team. This endpoint lists your organization's teams. Team and membership writes (create a team, invite/remove members) are managed from the dashboard today and are not yet part of this public API's documented surface.

Authentication

Requires the base IM access every endpoint in this API needs: an IM-eligible role (admin, editor, or responder), or an organization-wide API token. Incident Management must be enabled for the organization.

Example (cURL)

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

Response

200 OK: an array, ordered by name.

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

Common errors

• 401 Unauthorized when not authenticated
• 403 Forbidden (imAccessDenied) when using a customer-scoped token, or a session without an IM-eligible role
• 403 Forbidden (imNotEnabled) when Incident Management is not enabled for the organization