Skip to main content
Teams group members together so you can assign issues, configure alert routing, and control project access at a team level. Use these endpoints to create teams, manage membership, and list a team’s projects.

​
List teams

GET /api/0/organizations/{organization_id_or_slug}/teams/
Returns all teams in the organization. Required scope: team:read

​
Path parameters

​
organization_id_or_slug
string
required
The numeric ID or slug of the organization.

​
Example request

curl https://sentry.io/api/0/organizations/my-org/teams/ \
  -H "Authorization: Bearer sntrys_TOKEN"

​
Example response

[
  {
    "id": "3",
    "slug": "backend",
    "name": "Backend Team",
    "dateCreated": "2019-01-15T00:00:00Z",
    "isMember": true,
    "memberCount": 5,
    "projects": []
  }
]

​
Response fields

​
id
string
The team’s numeric ID, returned as a string.
​
slug
string
The URL-friendly identifier for the team.
​
name
string
The display name of the team.
​
dateCreated
string
ISO 8601 timestamp of when the team was created.
​
isMember
boolean
Whether the authenticated user is a member of this team.
​
memberCount
integer
The total number of members in the team.

​
Create a team

POST /api/0/organizations/{organization_id_or_slug}/teams/
Creates a new team in the organization. Required scope: team:write

​
Request body

​
name
string
required
The display name for the team.
​
slug
string
A URL-friendly identifier. If omitted, Sentry generates one from the team name.

​
Example request

curl -X POST https://sentry.io/api/0/organizations/my-org/teams/ \
  -H "Authorization: Bearer sntrys_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Backend Team", "slug": "backend"}'

​
Example response

{
  "id": "3",
  "slug": "backend",
  "name": "Backend Team",
  "dateCreated": "2024-01-15T10:00:00Z",
  "isMember": false,
  "memberCount": 0
}

​
Retrieve a team

GET /api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/
Returns details for a single team. Required scope: team:read

​
Path parameters

​
organization_id_or_slug
string
required
The numeric ID or slug of the organization.
​
team_id_or_slug
string
required
The numeric ID or slug of the team.

​
Example request

curl https://sentry.io/api/0/teams/my-org/backend/ \
  -H "Authorization: Bearer sntrys_TOKEN"

​
List team members

GET /api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/members/
Returns a paginated list of members in the team. Required scope: team:read

​
Example request

curl https://sentry.io/api/0/teams/my-org/backend/members/ \
  -H "Authorization: Bearer sntrys_TOKEN"

​
Example response

[
  {
    "id": "1",
    "email": "jane@example.com",
    "name": "Jane Smith",
    "role": "member",
    "pending": false,
    "dateCreated": "2019-03-22T10:00:00Z"
  }
]

​
Response fields

​
id
string
The member’s unique ID within the organization.
​
email
string
The member’s email address.
​
name
string
The member’s display name.
​
role
string
The member’s organization role, e.g. "admin", "member", "owner".
​
pending
boolean
true if the member has been invited but has not yet accepted.

​
List team projects

GET /api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/projects/
Returns the projects that this team has access to. Required scope: team:read

​
Example request

curl https://sentry.io/api/0/teams/my-org/backend/projects/ \
  -H "Authorization: Bearer sntrys_TOKEN"

​
Example response

[
  {
    "id": "2",
    "slug": "my-project",
    "name": "My Project",
    "platform": "python",
    "dateCreated": "2018-11-06T21:19:58.536Z",
    "status": "active"
  }
]