[metadata]
og:image: https://sentry-docs-bpt555yka.sentry.dev/og-images/api-permissions.png
og:image:height: 630
og:image:width: 1200
og:title: Permissions & Scopes
og:type: website
twitter:card: summary_large_image
twitter:image: https://sentry-docs-bpt555yka.sentry.dev/og-images/api-permissions.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: Permissions & Scopes
viewport: width=device-width, initial-scale=1
zd-site-verification: ocu6mswx6pke3c6qvozr2e

[canonical-links]
https://docs.sentry.io/api/permissions/

[document-links]
AI: /ai/
API Reference: /api/
API: /api/
Auth Tokens: /api/auth/
Authentication: /api/auth/
Crons: /api/crons/
Dashboards: /api/dashboards/
Discover & Performance: /api/discover/
Docs: /
Environments: /api/environments/
Events & Issues: /api/events/
Explore: /api/explore/
Go to Sentry: https://sentry.io/
Guides: /guides/
Home: /
Integration Platform: /api/integration/
Integrations: /api/integrations/
Mobile Builds: /api/mobile-builds/
Monitors & Alerts: /api/monitors/
Next Rate Limits: /api/ratelimits/
Open Membership: /organization/membership/#open-membership
Organizations: /api/organizations/
Paginating Results: /api/pagination/
Permissions & Scopes: /api/permissions/
Previous Paginating Results: /api/pagination/
Product Changelog: https://sentry.io/changelog/
Product: /product/
Profiling: /api/profiling/
Projects: /api/projects/
Rate Limits: /api/ratelimits/
Releases: /api/releases/
Replays: /api/replays/
Requests: /api/requests/
SCIM: /api/scim/
SDKs: /platforms/
Sandbox: https://sandbox.sentry.io/
Seer: /api/seer/
Snapshots: /api/snapshots/
Spike Protection Notifications: /api/spike-protection/
Teams: /api/teams/
Users: /api/users/
creating a personal token: https://sentry.io/api/
integration token: /integrations/integration-platform/#permissions
manage your releases: /cli/releases/
membership: /organization/membership/

[content]
Permissions & Scopes
Skip to content
Docs
SDKs
Product
AI
Guides
Concepts
API
Manage
Ask AI
Go to Sentry
Open Main Menu
API Reference
Authentication
Paginating Results
Permissions & Scopes
Rate Limits
Requests
Crons
Dashboards
Discover & Performance
Environments
Events & Issues
Explore
Integration Platform
Integrations
Mobile Builds
Monitors & Alerts
Organizations
Profiling
Projects
Releases
Replays
SCIM
Seer
Snapshots
Spike Protection Notifications
Teams
Users
Product Changelog
Sandbox
More
Home
API Reference
Permissions & Scopes
Copy page
Permissions & Scopes
If you're building on top of Sentry's API (i.e using
Auth Tokens
), you'll need certain scopes to access different API endpoints.
To set the scopes for an
integration token
, select the scopes from the dropdown. These can be edited later.
To set the scopes for an personal token, select the scopes from the dropdown when
creating a personal token
. These cannot be edited later.
If you're looking for information on membership roles please visit the
membership
documentation.
Organizations
GET
org:read
PUT/POST
org:write
DELETE
org:admin
Continuous Integration (CI)
CI Workflows
org:ci
Use the
org:ci
scope for CI and deployment workflows, including uploading source maps, creating releases, and managing code mappings.
Projects
GET
project:read
PUT/POST
project:write
DELETE
project:admin
Note
The
project:releases
scope will give you access to both
project
and
organization
release endpoints. The available endpoints are listed in the
Releases
section of the API Documentation.
Teams
GET
team:read
PUT/POST
team:write
DELETE
team:admin
Members
GET
member:read
PUT/POST
member:write
DELETE
member:admin
Issues & Events
GET
event:read
PUT
event:write
DELETE
event:admin
Note
PUT/DELETE
methods only apply to updating/deleting issues. Events in Sentry are immutable and can only be deleted by deleting the whole issue.
Releases
GET/PUT/POST/DELETE
project:releases
Note
Be aware that if you're using
sentry-cli
to
manage your releases
, you'll need a token which also has
org:read
scope.
Project Access
In addition to the
project:releases
scope, mutations on releases (create, update, delete, file uploads, deploys) require that the user has access to
all
projects associated with the release. If your organization has
Open Membership
disabled, members can only modify releases for projects belonging to teams they are a member of.
Previous
Paginating Results
Next
Rate Limits
Was this helpful?
Yes 👍
No 👎
How can we improve this page?
Email
(optional)
Submit feedback
