Teams are groups of members that are associated with one or more projects. Use teams to control which members have access to which projects.
List teams in an organization
GET /api/0/organizations/{organization_id_or_slug}/teams/
team:read
Path parameters
The ID or slug of the organization.
Query parameters
Set to "1" to include team member details in the response.
Pagination cursor from the Link response header.
Example request
curl https://sentry.io/api/0/organizations/my-org/teams/ \
-H "Authorization: Bearer <token>"
Example response
[
{
"id": "1",
"slug": "backend",
"name": "Backend",
"dateCreated": "2018-11-06T21:20:08Z",
"isMember": true,
"memberCount": 5,
"avatar": {
"avatarType": "letter_avatar",
"avatarUuid": null
}
}
]
Response fields
The unique ID of the team.
The URL-friendly identifier for the team.
The display name of the team.
ISO 8601 timestamp of when the team was created.
Whether the authenticated user is a member of this team.
The number of members in the team.
Create a team
POST /api/0/organizations/{organization_id_or_slug}/teams/
team:write
Path parameters
The ID or slug of the organization.
Request body
The display name for the team.
A unique slug for the team. Generated from the name if not provided.
Example request
curl -X POST https://sentry.io/api/0/organizations/my-org/teams/ \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"name": "Frontend"}'
Retrieve a team
GET /api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/
team:read
Path parameters
The ID or slug of the organization.
The ID or slug of the team.
Example request
curl https://sentry.io/api/0/teams/my-org/backend/ \
-H "Authorization: Bearer <token>"
Add a member to a team
POST /api/0/organizations/{organization_id_or_slug}/members/{member_id}/teams/{team_id_or_slug}/
team:write
Path parameters
The ID or slug of the organization.
The ID of the organization member.
The ID or slug of the team.
Example request
curl -X POST https://sentry.io/api/0/organizations/my-org/members/1/teams/backend/ \
-H "Authorization: Bearer <token>"
Remove a member from a team
DELETE /api/0/organizations/{organization_id_or_slug}/members/{member_id}/teams/{team_id_or_slug}/
team:write
Path parameters
The ID or slug of the organization.
The ID of the organization member.
The ID or slug of the team to remove the member from.
Example request
curl -X DELETE https://sentry.io/api/0/organizations/my-org/members/1/teams/backend/ \
-H "Authorization: Bearer <token>"
200 OK with the updated team membership object. 
