Skip to main content
Member endpoints let you manage who has access to your organization, including inviting new users and assigning roles.

​
Member roles

Every member is assigned a role that controls what they can do within the organization:
RoleDescription
ownerFull access including organization deletion and all settings
managerCan manage members, teams, and most organization settings
adminCan manage teams and projects they are a member of
memberCan view and interact with issues in their teams’ projects

​
List organization members

GET /api/0/organizations/{organization_id_or_slug}/members/
Returns a paginated list of members belonging to the organization. Required scope: member:read

​
Path parameters

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

​
Query parameters

​
query
string
Filter members by name or email address.
​
cursor
string
Pagination cursor from the Link response header.

​
Example request

curl https://sentry.io/api/0/organizations/my-org/members/ \
  -H "Authorization: Bearer <token>"

​
Example response

[
  {
    "id": "1",
    "email": "[email protected]",
    "name": "Jane Doe",
    "role": "member",
    "roleName": "Member",
    "pending": false,
    "expired": false,
    "dateCreated": "2018-11-06T21:19:55Z",
    "user": {
      "id": "42",
      "email": "[email protected]",
      "username": "[email protected]",
      "name": "Jane Doe",
      "isActive": true
    }
  }
]

​
Response fields

​
id
string
The unique ID of the organization membership.
​
email
string
The member’s email address.
​
name
string
The member’s display name.
​
role
string
The member’s role. One of owner, manager, admin, or member.
​
pending
boolean
Whether the invitation is still pending acceptance.
​
expired
boolean
Whether the invitation has expired.
​
dateCreated
string
ISO 8601 timestamp of when the membership was created.
​
user
object | null
The user object, or null if the invitation is pending.

​
Invite a member

POST /api/0/organizations/{organization_id_or_slug}/members/
Invites a new member to join the organization by sending them an invitation email. Required scope: member:write

​
Path parameters

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

​
Request body

​
email
string
required
The email address to send the invitation to.
​
role
string
required
The role to assign. One of owner, manager, admin, or member.
​
teams
array
A list of team slugs to add the member to upon acceptance.

​
Example request

curl -X POST https://sentry.io/api/0/organizations/my-org/members/ \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "role": "member", "teams": ["backend"]}'

​
Retrieve a member

GET /api/0/organizations/{organization_id_or_slug}/members/{member_id}/
Returns details for a single organization member. Required scope: member:read

​
Path parameters

​
organization_id_or_slug
string
required
The ID or slug of the organization.
​
member_id
string
required
The ID of the member. Use me to reference the currently authenticated user.

​
Example request

curl https://sentry.io/api/0/organizations/my-org/members/1/ \
  -H "Authorization: Bearer <token>"

​
Remove a member

DELETE /api/0/organizations/{organization_id_or_slug}/members/{member_id}/
Removes a member from the organization. This does not delete the user’s Sentry account. Required scope: member:write

​
Path parameters

​
organization_id_or_slug
string
required
The ID or slug of the organization.
​
member_id
string
required
The ID of the member to remove.

​
Example request

curl -X DELETE https://sentry.io/api/0/organizations/my-org/members/1/ \
  -H "Authorization: Bearer <token>"
A successful removal returns 204 No Content.

Build docs developers (and LLMs) love

Get started for freeTalk to us