List teams

GET https://app.eraser.io/api/teams

Lists the teams this API token can act on. A team token returns its single team with organization set to null. An organization API token returns every team in the organization; pass a returned id as teamId on other endpoints. No scope is required.

Responses

200 – The token's organization (if any) and the teams it can act on

organization object | null required2 fields

Null for team tokens; set for organization API tokens.

id string

Organization id

name string

Organization name

teams object[] required3 fields

Teams this token can act on, sorted by name.

id string required

Team id – the value to pass as teamId.

name string required

Team name

createdAt string required

ISO 8601 timestamp of when the team was created

nextCursor null required

Always null today; reserved so pagination can be added without a breaking change.

200 response

{
  "organization": {
    "id": "string",
    "name": "string"
  },
  "teams": [
    {
      "id": "string",
      "name": "string",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ]
}

401 – Missing or invalid API token

403 – API token is disabled

Example request

curl

curl -X GET 'https://app.eraser.io/api/teams' \
  -H 'Authorization: Bearer $ERASER_API_TOKEN'