Node reference
Sentry
Sentry node reference - all 223 operations, the credential it needs, and a worked example.
Sentry Web API (Developer tools). 223 operations: issues (list, get, update, delete, bulk mutate, hashes, tags, events, external-issue links), events and attachments, projects with their client keys (DSNs), inbound filters, ownership rules, symbol sources and service hooks, organizations, teams and members, releases with files, commits and deploys, cron monitors and check-ins, alerts and detectors, Discover and Explore queries, traces and tags, dashboards, environments, session replays, profiling, mobile builds and snapshots, spike protection, integrations and custom apps, SCIM provisioning, and Seer.
Credential: Sentry auth token - see Credentials.
Scopes
Each operation below lists the scope it needs. Scopes are ticked on the token when it is created, and WHICH KIND of token you made decides whether you can ever change your mind. Sentry mints three and they are not interchangeable. A user auth token (User settings -> User Auth Tokens) acts as the person, reaches every organization they belong to, and its scopes are FIXED at creation - widening one means minting a replacement and re-pasting the credential. An organization auth token (Settings -> Auth Tokens) is scoped to one organization and to a fixed release/CI set (org:ci, project:releases, project:read), has no user behind it, and therefore cannot reach the member or org-admin endpoints at all whatever you do; it is also shown exactly once, at creation. An internal integration token (Settings -> Custom Integrations) is org-scoped and its scopes stay EDITABLE, which is why it is the right kind for a workflow. The scopes themselves are coarse and verb-shaped - <resource>:read for GET, :write for PUT/POST, :admin for DELETE - across org, project, team, member, event and alerts, with two that do not follow the pattern: project:releases covers BOTH the project and the organization release endpoints (which is why the release rows name it rather than a release-specific scope that does not exist), and org:ci is the CI/deploy scope an organization token carries. Values joined by "or" below are ALTERNATIVES, not a required set: any one of them satisfies the endpoint. Three refusals are not a missing scope. A 401 is the token itself - revoked, expired, or pasted with the Bearer prefix still attached. A 404 is Sentry hiding a resource the token may not see, so it is indistinguishable from a mistyped organization or project slug - and from an organization stored in the other data region, because a US organization answers 404 on de.sentry.io and vice versa. A 429 is the rate limit, which is applied per caller AND per endpoint with a separate concurrency cap; the X-Sentry-Rate-Limit-Remaining, -Reset and -ConcurrentRemaining response headers say where you stand, and Sentry's own advice is that polling a list on a short schedule will trigger it. If a run fails with a permission error, the node names the missing scope in the error - grant it and re-run; you do not need to rebuild the workflow.
Operations (223)
Issues
| Operation | What it does | Scope |
|---|---|---|
resolveIssue | Resolve an issue (legacy) | event:write (or event:admin) |
updateIssueStatus | Set an issue's status (legacy) | event:write (or event:admin) |
assignIssue | Assign an issue (legacy) | event:write (or event:admin) |
addComment | Comment on an issue (legacy) | event:write (or event:admin) |
getEventDetail | Get an issue's latest event (legacy) | event:read (or event:write, event:admin) |
bulkDeleteIssues | Bulk Remove an Organization's Issues | event:admin |
bulkDeleteProjectIssues | Bulk Remove a List of Issues | event:admin |
bulkUpdateIssues | Bulk Mutate an Organization's Issues | event:admin (or event:write) |
bulkUpdateProjectIssues | Bulk Mutate a List of Issues | event:write |
deleteIssue | Remove an Issue | event:admin |
getIssue | Retrieve an Issue | event:admin (or event:read, event:write) |
getIssueEvent | Retrieve an Issue Event | event:admin (or event:read, event:write) |
getIssueTag | Retrieve Tag Details | event:admin (or event:read, event:write) |
listIssueEvents | List an Issue's Events | event:admin (or event:read, event:write) |
listIssueHashes | List an Issue's Hashes | event:admin (or event:read, event:write) |
listIssues | List a Project's Issues | event:read |
listIssueTagValues | List a Tag's Values for an Issue | event:admin (or event:read, event:write) |
listOrgIssues | List an Organization's Issues | event:admin (or event:read, event:write) |
updateIssue | Update an Issue | event:admin (or event:write) |
Events & attachments
| Operation | What it does | Scope |
|---|---|---|
getProjectEvent | Retrieve an Event for a Project | project:admin (or project:read, project:write) |
getProjectEventAttachment | Retrieve an Event Attachment | project:admin (or project:read, project:write) |
getProjectEventSourceMapDebug | Get Debug Information Related to Source Maps for a Given Event | project:admin (or project:read, project:write) |
listProjectEventAttachments | List an Event's Attachments | project:admin (or project:read, project:write) |
listProjectEvents | List a Project's Error Events | project:admin (or project:read, project:write) |
Projects
| Operation | What it does | Scope |
|---|---|---|
addProjectSymbolSource | Add a Symbol Source to a Project | project:admin (or project:write) |
addProjectTeam | Add a Team to a Project | project:admin (or project:write) |
createProject | Create a Project for an Organization | project:admin (or project:read, project:write) |
createProjectKey | Create a New Client Key | project:admin (or project:write) |
createServiceHook | Register a New Service Hook | project:write |
createTeamProject | Create a New Project | project:admin (or project:write) |
deleteProject | Delete a Project | project:admin |
deleteProjectKey | Delete a Client Key | project:admin |
deleteProjectSymbolSource | Delete a Symbol Source from a Project | project:admin |
deleteProjectTeam | Delete a Team from a Project | project:admin (or project:write) |
deleteServiceHook | Remove a Service Hook | project:admin |
disableSpikeProtection | Disable Spike Protection | project:read (or project:write, project:admin) |
enableSpikeProtection | Enable Spike Protection | project:read (or project:write, project:admin) |
getProject | Retrieve a Project | project:admin (or project:read, project:write) |
getProjectKey | Retrieve a Client Key | project:admin (or project:read, project:write) |
getProjectOwnership | Retrieve Ownership Configuration for a Project | project:admin (or project:read, project:write) |
getServiceHook | Retrieve a Service Hook | project:read |
linkProjectRepository | Link a Repository to a Project | project:admin (or project:write) |
listProjectDebugFiles | List a Project's Debug Information Files | org:ci (or project:admin, project:read, project:releases, project:write) |
listProjectFilters | List a Project's Data Filters | project:admin (or project:read, project:write) |
listProjectKeys | List a Project's Client Keys | project:admin (or project:read, project:write) |
listProjectMembers | List a Project's Organization Members | project:admin (or project:read, project:write) |
listProjectStats | Retrieve Event Counts for a Project | project:admin (or project:read, project:write) |
listProjectSymbolSources | Retrieve a Project's Symbol Sources | project:admin (or project:read, project:write) |
listProjectTagValues | List a Tag's Values | project:read |
listProjectUsers | List a Project's Users | project:admin (or project:read, project:write) |
listServiceHooks | List a Project's Service Hooks | project:read |
listUserFeedback | List a Project's User Feedback | project:read |
submitUserFeedback | Submit User Feedback | project:write — or a project DSN instead of a token |
updateProject | Update a Project | project:admin (or project:read, project:write) |
updateProjectFilter | Update an Inbound Data Filter | project:admin (or project:write) |
updateProjectKey | Update a Client Key | project:admin (or project:write) |
updateProjectOwnership | Update Ownership Configuration for a Project | project:admin (or project:read, project:write) |
updateProjectSymbolSource | Update a Project's Symbol Source | project:admin (or project:write) |
updateServiceHook | Update a Service Hook | project:write |
Organizations
| Operation | What it does | Scope |
|---|---|---|
getEventCounts | Retrieve Event Counts for an Organization (v2) | org:admin (or org:read, org:write) |
getEventCountsByProject | Retrieve an Organization's Events Count by Project | org:admin (or org:read, org:write) |
getOrganization | Retrieve an Organization | org:admin (or org:read, org:write) |
listOrganizations | List Your Organizations | org:admin (or org:read, org:write) |
listOrgClientKeys | List an Organization's Client Keys | org:admin (or org:read, org:write) |
listProjects | List an Organization's Projects | org:admin (or org:read, org:write) |
listRelayUsage | List an Organization's trusted Relays | org:admin (or org:read, org:write) |
listRepoCommits | List a Repository's Commits | org:admin (or org:read, org:write) |
listRepos | List an Organization's Repositories | org:admin (or org:ci, org:integrations, org:read, org:write) |
resolveEventId | Resolve an Event ID | org:admin (or org:read, org:write) |
resolveShortId | Resolve a Short ID | event:admin (or event:read, event:write) |
updateOrganization | Update an Organization | org:admin (or org:write) |
Teams & members
| Operation | What it does | Scope |
|---|---|---|
addMember | Add a Member to an Organization | member:admin (or member:invite, member:write) |
addMemberTeam | Add an Organization Member to a Team | org:read (or org:write, team:write) |
createTeam | Create a New Team | org:admin (or org:write, team:write) |
deleteMember | Delete an Organization Member | member:admin (or member:read, member:write) |
deleteMemberTeam | Delete an Organization Member from a Team | org:admin (or org:read, org:write, team:admin) |
deleteTeam | Delete a Team | team:admin |
getMember | Retrieve an Organization Member | member:admin (or member:read, member:write) |
getTeam | Retrieve a Team | team:admin (or team:read, team:write) |
listMembers | List an Organization's Members | member:admin (or member:read, member:write) |
listProjectTeams | List a Project's Teams | project:admin (or project:read, project:write) |
listTeamMembers | List a Team's Members | team:admin (or team:read, team:write) |
listTeamProjects | List a Team's Projects | project:admin (or project:read, project:write) |
listTeams | List an Organization's Teams | org:admin (or org:read, org:write) |
listUserTeams | List a User's Teams for an Organization | org:admin (or org:read, org:write) |
updateMember | Update an Organization Member's Roles | member:admin (or member:invite, member:write) |
updateMemberTeam | Update an Organization Member's Team Role | member:admin (or member:read, member:write, org:admin, org:read, org:write, team:admin, team:write) |
updateTeam | Update a Team | team:admin (or team:write) |
Releases & deploys
| Operation | What it does | Scope |
|---|---|---|
createRelease | Create a New Release for an Organization | org:ci (or project:admin, project:releases, project:write) |
createReleaseDeploy | Create a Deploy | org:ci (or project:admin, project:releases, project:write) |
deleteProjectReleaseFile | Delete a Project Release's File | project:admin (or project:releases) |
deleteRelease | Delete an Organization's Release | project:admin (or project:releases) |
deleteReleaseFile | Delete an Organization Release's File | project:admin (or project:releases) |
getProjectReleaseFile | Retrieve a Project Release's File | org:ci (or project:admin, project:read, project:releases, project:write) |
getRelease | Retrieve an Organization's Release | org:ci (or project:admin, project:read, project:releases, project:write) |
getReleaseFile | Retrieve an Organization Release's File | org:ci (or project:admin, project:read, project:releases, project:write) |
getSessionStats | Retrieve Release Health Session Statistics | org:admin (or org:read, org:write) |
listProjectReleaseCommits | List a Project Release's Commits | org:ci (or project:admin, project:read, project:releases, project:write) |
listProjectReleaseFiles | List a Project's Release Files | org:ci (or project:admin, project:read, project:releases, project:write) |
listProjectReleases | List a Project's Releases | org:ci (or project:admin, project:read, project:releases, project:write) |
listReleaseCommitFiles | Retrieve Files Changed in a Release's Commits | project:releases |
listReleaseCommits | List an Organization Release's Commits | org:ci (or project:admin, project:read, project:releases, project:write) |
listReleaseDeploys | List a Release's Deploys | org:ci (or project:admin, project:read, project:releases, project:write) |
listReleaseFiles | List an Organization's Release Files | org:ci (or project:admin, project:read, project:releases, project:write) |
listReleases | List an Organization's Releases | org:ci (or project:admin, project:read, project:releases, project:write) |
listReleaseThresholdStatuses | Retrieve Statuses of Release Thresholds (Alpha) | org:ci (or project:admin, project:read, project:releases, project:write) |
updateProjectReleaseFile | Update a Project Release File | org:ci (or project:admin, project:releases, project:write) |
updateRelease | Update an Organization's Release | org:ci (or project:admin, project:releases, project:write) |
updateReleaseFile | Update an Organization Release File | org:ci (or project:admin, project:releases, project:write) |
Crons & monitors
| Operation | What it does | Scope |
|---|---|---|
createMonitor | Create a Monitor | alerts:write (or org:admin, org:read, org:write) |
deleteMonitor | Delete a Monitor or Monitor Environments | alerts:write (or project:admin, project:write) |
deleteProjectMonitor | Delete a Monitor or Monitor Environments for a Project | alerts:write (or project:admin, project:write) |
getMonitor | Retrieve a Monitor | alerts:read (or alerts:write, project:admin, project:read, project:write) |
getProjectMonitor | Retrieve a Monitor for a Project | alerts:read (or alerts:write, project:admin, project:read, project:write) |
listMonitorCheckins | Retrieve Check-Ins for a Monitor | alerts:read (or alerts:write, project:admin, project:read, project:write) |
listMonitors | Retrieve Monitors for an Organization | alerts:read (or org:admin, org:read, org:write) |
listProjectMonitorCheckins | Retrieve Check-Ins for a Monitor by Project | alerts:read (or alerts:write, project:admin, project:read, project:write) |
updateMonitor | Update a Monitor | alerts:write (or project:admin, project:write) |
updateProjectMonitor | Update a Monitor for a Project | alerts:write (or project:admin, project:write) |
Alerts & detectors
| Operation | What it does | Scope |
|---|---|---|
bulkDeleteAlerts | Bulk Delete Alerts | alerts:write (or org:admin, org:write) |
bulkDeleteDetectors | Bulk Delete Monitors | alerts:write (or org:admin, org:read, org:write) |
bulkUpdateAlerts | Mutate an Organization's Alerts | alerts:write (or org:admin, org:write) |
bulkUpdateDetectors | Mutate an Organization's Monitors | alerts:write (or org:admin, org:read, org:write) |
createAlert | Create an Alert for an Organization | alerts:write (or org:admin, org:write) |
createProjectDetector | Create a Monitor for a Project | alerts:write (or project:admin, project:write) |
deleteAlert | Delete an Alert | alerts:write (or org:admin, org:write) |
deleteDetector | Delete a Monitor | alerts:write (or org:admin, org:read, org:write) |
getAlert | Fetch an Alert | alerts:read (or org:admin, org:read, org:write) |
getDetector | Fetch a Monitor | alerts:read (or org:admin, org:read, org:write) |
listAlerts | Fetch Alerts | alerts:read (or org:admin, org:read, org:write) |
listDetectors | Fetch an Organization's Monitors | alerts:read (or org:admin, org:read, org:write) |
updateAlert | Update an Alert by ID | alerts:write (or org:admin, org:write) |
updateDetector | Update a Monitor by ID | alerts:write (or org:admin, org:read, org:write) |
Discover, traces & tags
| Operation | What it does | Scope |
|---|---|---|
createDiscoverSavedQuery | Create a New Saved Query | org:admin (or org:read, org:write) |
deleteDiscoverSavedQuery | Delete an Organization's Discover Saved Query | org:admin (or org:read, org:write) |
getDiscoverSavedQuery | Retrieve an Organization's Discover Saved Query | org:admin (or org:read, org:write) |
getTrace | Retrieve a Trace | org:admin (or org:read, org:write) |
getTraceMeta | Retrieve Trace Metadata | org:admin (or org:read, org:write) |
listDiscoverSavedQueries | List an Organization's Discover Saved Queries | org:admin (or org:read, org:write) |
listTags | List an Organization's Tags | org:admin (or org:read, org:write) |
listTraceItemAttributes | List Trace Item Attributes | org:admin (or org:read, org:write) |
updateDiscoverSavedQuery | Edit an Organization's Discover Saved Query | org:admin (or org:read, org:write) |
Explore queries
| Operation | What it does | Scope |
|---|---|---|
getTraceItemStats | Retrieve Trace Item Statistics | org:admin (or org:read, org:write) |
queryEvents | Query Explore Events in Table Format | org:admin (or org:read, org:write) |
queryEventsTimeseries | Query Explore Events in Timeseries Format | org:admin (or org:read, org:write) |
Dashboards
| Operation | What it does | Scope |
|---|---|---|
createDashboard | Create a New Dashboard for an Organization | org:admin (or org:read, org:write) |
deleteDashboard | Delete an Organization's Custom Dashboard | org:admin (or org:read, org:write) |
getDashboard | Retrieve an Organization's Custom Dashboard | org:admin (or org:read, org:write) |
listDashboards | List an Organization's Custom Dashboards | org:admin (or org:read, org:write) |
updateDashboard | Edit an Organization's Custom Dashboard | org:admin (or org:read, org:write) |
Environments
| Operation | What it does | Scope |
|---|---|---|
bulkUpdateProjectEnvironments | Bulk Update Project Environments | project:admin (or project:write) |
getProjectEnvironment | Retrieve a Project Environment | project:admin (or project:read, project:write) |
listEnvironments | List an Organization's Environments | org:admin (or org:read, org:write) |
listProjectEnvironments | List a Project's Environments | project:admin (or project:read, project:write) |
updateProjectEnvironment | Update a Project Environment | project:admin (or project:write) |
Session replays
| Operation | What it does | Scope |
|---|---|---|
createProjectReplayDeletionJob | Create Replay Batch Deletion Job | project:admin (or project:write) |
deleteProjectReplay | Delete a Replay Instance | project:admin (or project:write) |
getProjectReplayDeletionJob | Retrieve a Replay Batch-Deletion Job | project:admin (or project:write) |
getProjectReplayRecordingSegment | Retrieve a Recording Segment | project:admin (or project:read, project:write) |
getReplay | Retrieve a Replay Instance | org:admin (or org:read, org:write) |
getReplayCount | Retrieve a Count of Replays for a Given Issue or Transaction | org:admin (or org:read, org:write) |
listProjectReplayClicks | List Clicked Nodes | project:admin (or project:read, project:write) |
listProjectReplayDeletionJobs | List Replay Batch-Deletion Jobs | project:admin (or project:write) |
listProjectReplayRecordingSegments | List Recording Segments | project:admin (or project:read, project:write) |
listProjectReplayViewedBy | List Users Who Have Viewed a Replay | event:admin (or event:read, event:write) |
listReplays | List an Organization's Replays | org:admin (or org:read, org:write) |
listReplaySelectors | List an Organization's Selectors | org:admin (or org:read, org:write) |
Profiling
| Operation | What it does | Scope |
|---|---|---|
getProfilingFlamegraph | Retrieve a Flamegraph for an Organization | org:admin (or org:read, org:write) |
getProjectProfilingProfile | Retrieve a Profile | project:admin (or project:read, project:write) |
listProfilingChunks | Retrieve Profile Chunks for an Organization | org:admin (or org:read, org:write) |
Mobile builds & snapshots
| Operation | What it does | Scope |
|---|---|---|
deletePreprodArtifactSnapshot | Delete a Snapshot | project:admin (or project:releases) |
getPreprodArtifactInstallDetails | Retrieve install info for a given artifact | org:admin (or org:read, org:write) |
getPreprodArtifactSizeAnalysis | Retrieve Size Analysis results for a given artifact | org:admin (or org:read, org:write) |
getPreprodArtifactSnapshot | Retrieve Snapshot details | org:ci (or project:admin, project:read, project:releases, project:write) |
getPreprodArtifactSnapshotImage | Retrieve Snapshot image detail | org:ci (or project:admin, project:read, project:releases, project:write) |
getPreprodArtifactSnapshotLatestBase | Retrieve latest base Snapshot | org:ci (or project:admin, project:read, project:releases, project:write) |
getProjectInstallableBuildLatest | Get the latest installable build for a project | project:admin (or project:distribution, project:read, project:write) |
getProjectPreprodSizeAnalysisStatusCheckRules | Retrieve Size Analysis status check rules for a project | project:admin (or project:read, project:write) |
getProjectPreprodSnapshotStatusCheckRules | Retrieve Snapshot status check rules for a project | project:admin (or project:read, project:write) |
Spike protection
| Operation | What it does | Scope |
|---|---|---|
createNotificationsAction | Create a Spike Protection Notification Action | org:admin (or org:read, org:write) |
deleteNotificationsAction | Delete a Spike Protection Notification Action | org:admin (or org:read, org:write) |
getNotificationsAction | Retrieve a Spike Protection Notification Action | org:admin (or org:read, org:write) |
listNotificationsActions | List Spike Protection Notifications | org:admin (or org:read, org:write) |
updateNotificationsAction | Update a Spike Protection Notification Action | org:admin (or org:read, org:write) |
Integrations & custom apps
| Operation | What it does | Scope |
|---|---|---|
createExternalUser | Create an External User | org:admin (or org:write) |
createForwarding | Create a Data Forwarder for an Organization | org:write |
createLinkedExternalIssue | Create an External Issue and Link It to an Issue | event:admin (or event:write) |
createTeamExternalTeam | Create an External Team | team:admin (or team:write) |
deleteAppExternalIssue | Delete an External Issue | event:admin |
deleteExternalUser | Delete an External User | org:admin (or org:write) |
deleteForwarding | Delete a Data Forwarder for an Organization | org:write |
deleteIntegration | Delete an Integration for an Organization | org:admin (or org:integrations) |
deleteSentryApp | Delete a custom integration. | org:admin |
deleteTeamExternalTeam | Delete an External Team | team:admin |
getConfigIntegrations | Get Integration Provider Information | org:admin (or org:read, org:write) |
getIntegration | Retrieve an Integration for an Organization | org:admin (or org:integrations, org:read, org:write) |
getIssueIntegrationConfig | Retrieve an Integration's Issue Config for an Issue | event:admin (or event:read, event:write) |
getSentryApp | Retrieve a custom integration by ID or slug. | event:admin (or event:read, event:write, member:read, org:read, project:read, project:releases, team:read) |
linkExternalIssue | Link an Existing External Issue to an Issue | event:admin (or event:write) |
listAppInstallations | List an Organization's Integration Platform Installations | org:read (or org:integrations) |
listForwarding | Retrieve Data Forwarders for an Organization | org:read |
listIntegrations | List an Organization's Available Integrations | org:admin (or org:integrations, org:read, org:write) |
listIssueExternalIssues | Retrieve custom integration issue links for the given Sentry issue | event:admin (or event:read, event:write) |
listSentryApps | Retrieve the custom integrations created by an organization | org:admin (or org:read, org:write) |
unlinkExternalIssue | Unlink an External Issue from an Issue | event:admin |
updateExternalUser | Update an External User | org:admin (or org:write) |
updateForwarding | Update a Data Forwarder for an Organization | org:write |
updateSentryApp | Update an existing custom integration. | org:admin (or org:write) |
updateTeamExternalTeam | Update an External Team | team:admin (or team:write) |
upsertAppExternalIssue | Create or update an External Issue | event:write |
SCIM provisioning
| Operation | What it does | Scope |
|---|---|---|
deleteScimV2Group | Delete an Individual Team | team:admin |
deleteScimV2User | Delete an Organization Member via SCIM | member:admin |
getScimV2Group | Query an Individual Team | team:admin (or team:read, team:write) |
getScimV2User | Query an Individual Organization Member | member:admin (or member:read, member:write) |
listScimV2Groups | List an Organization's Paginated Teams | team:admin (or team:read, team:write) |
listScimV2Users | List an Organization's SCIM Members | member:admin (or member:read, member:write) |
provisionScimV2Group | Provision a New Team | team:admin (or team:write) |
provisionScimV2User | Provision a New Organization Member | member:admin (or member:write) |
updateScimV2Group | Update a Team's Attributes | team:admin (or team:write) |
updateScimV2User | Update an Organization Member's Attributes | member:admin (or member:write) |
Seer (AI)
| Operation | What it does | Scope |
|---|---|---|
getIssueAutofixState | Retrieve Seer Issue Fix State | event:admin (or event:read, event:write) |
listSeerModels | List Seer AI Models | (any valid auth token — this endpoint declares no scope of its own) |
startIssueAutofix | Start Seer Issue Fix | event:admin (or event:write) |