Capability library / Application package

Sentry package v1.0.0

Sentry: read projects, issues and releases, update (resolve, merge, publish) or delete an issue, and delete a project.

Review state: Reviewed · Distributable: yes, digest matches the release manifest

This page describes AAES Govern’s controls. AAES Operate has private-work permissions, operational reviews and recorded-spend limits; it does not include Govern. About AAES Govern

Before you enable this package

The endpoint host 'sentry-api.invalid' is a reserved .invalid placeholder that fails closed until you substitute the real host in both the endpoint URLs and the egress allowlist.

Read each action's effects and exclusions below. Before installation, also read the complete package requirements, including credential issuance, scope, expiry, and provider permissions. These are deployment prerequisites, not capabilities this package supplies.

Capabilities (6)

Each capability below is one registered operation. The complete package JSON includes its exact network destination allowlist. The repository stores it at packs/sentry.json and embeds a copy in the release binary.

Risk tiers. R0 is the minimum for reads. R2 is the minimum for write, create, update, execute, and invoke. R3 is the minimum for delete, send, pay, deploy, approve, share, and transfer. Operators can raise these levels. A minimum tier does not measure the operation's business or confidentiality risk.

On supported execution paths routed through AAES Govern, the R3 actions listed below require approval by an authorized person. Bypass paths and observation-only registrations are outside that guarantee. A provider's restoration feature does not remove this approval requirement. A provider-side approval, such as approving a GitLab merge request, is also separate from AAES Govern human approval. The capability matrix shows which execution paths are implemented, restricted to lab use, or refused at startup. Live compatibility must be tested in your environment.

Field guide. Endpoint is the service address and request method. Connector is the adapter that makes the call. Custody describes how the credential is held; the credential reference identifies the value to resolve. Data class sets handling requirements: pii means personal data, financial means financial records, and internal means internal organizational data.

sentry.projects.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://sentry-api.invalid/api/0/organizations/ORG/projects/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
internal

Read projects.

List the projects in one Sentry organization: names, slugs, platforms and teams, which reveal internal application topology. The registered path covers the collection read only — single-project reads (GET /api/0/projects/{org}/{project}/) are not registered by this pack. ORG is a placeholder the deployment binds to the organization slug before enabling; the host is a reserved placeholder: substitute the customer's Sentry host before enabling.

sentry.issues.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://sentry-api.invalid/api/0/projects/ORG/PROJECT/issues/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
pii

Read issues.

List the issues (groups) bound to one project; according to the reviewed reference the endpoint takes its filters as query string parameters (a structured search query, a default of is:unresolved, sort and cursor pagination), requires the event:read scope, and is deprecated in favour of the organization issues endpoint, which this pack does not register. Issue metadata and event context routinely carry user identifiers, emails and IP addresses captured from the monitored application, so the read is classified as pii (personal data).

The registered path covers the collection read only — single-issue reads and the events of an issue are not registered. ORG and PROJECT are placeholders the deployment binds before enabling.

sentry.releases.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://sentry-api.invalid/api/0/organizations/ORG/releases/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
internal

Read releases.

List the releases in one Sentry organization: version strings, commit references and project associations, which reveal internal release and deployment topology. The registered path covers the collection read only — single-release reads, release file listings and deploy records are not registered by this pack. ORG is a placeholder the deployment binds before enabling.

sentry.issue.update v1.0.0R3

Kind
tool
Actions
update, delete, share
Endpoint
PUT https://sentry-api.invalid/api/0/organizations/ORG/issues/ISSUE_ID/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
pii

Update issue.

Update an issue's attributes. The unrestricted body also permits consequential operations documented in the single-issue Update an Issue reference:

Set status to resolved, ignored, or resolvedInNextRelease; these workflow resolutions are classified at R3. Set merge=true to merge issues, which cannot be unmerged. Set discard=true to discard issues rather than update them. Set isPublic=true to expose the issue to anyone with its link; removing access later cannot undo disclosure.

The capability therefore declares update, delete, and share at R3. Assignment and priority changes are ordinary updates within the same body. The operation requires event:write or event:admin.

Bind ORG and ISSUE_ID before enabling. The organization-wide bulk mutation endpoint is excluded.

sentry.issue.delete v1.0.0R3

Kind
tool
Action
delete
Endpoint
DELETE https://sentry-api.invalid/api/0/organizations/ORG/issues/ISSUE_ID/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
pii

Delete issue.

Delete one issue and its events; according to the reviewed Remove an Issue reference the call asynchronously queues the individual issue for deletion and requires the event:admin scope. Delete is one of the designated actions requiring human approval: a deleted issue's event history is not recoverable from Sentry, and future matching events create a new issue rather than restoring the old one. ORG and ISSUE_ID are placeholders the deployment binds before enabling.

sentry.project.delete v1.0.0R3

Kind
tool
Action
delete
Endpoint
DELETE https://sentry-api.invalid/api/0/projects/ORG/PROJECT/
Connector
http
Custody
customer_vault
Credential ref
secret-ref-sentry-auth-token
Data class
internal

Delete project.

Delete one project and all of its issues, events and release associations; deletion requires the project:admin scope. According to the reviewed Delete a Project reference, deletion is scheduled asynchronously rather than immediate — once begun, the project's state changes and it is hidden from most public views — so completion timing is not a guarantee of this registration, but the effect is deletion, and delete is one of the designated actions requiring human approval at the minimum R3 tier. ORG and PROJECT are placeholders the deployment binds before enabling.

Credential reference

The credential field names a reference rather than containing credential material. Packs are designed not to contain secrets; the format checks cover only known credential formats and cannot prove that arbitrary text contains no secrets. Installing a package registers its capabilities. Configure the provider credentials, endpoints, and network access, then test the integration in your environment before enabling it.

Reference
secret-ref-sentry-auth-token
Custody
customer_vault
Injection
header (Authorization)

Configure the value and injection format specified in the package. Assign responsibility for credential rotation and revocation, restrict provider permissions, and keep credential material out of logs and responses.

Complete credential requirements

A Sentry authentication token for the customer's own organization, held in the client's own secret manager. The stored material must be the complete Authorization header value: the scheme 'Bearer', one separating space, then the token — 'Bearer <token>'.

Issuance is external and two token kinds exist according to the reviewed authentication reference: an internal-integration token, created by an organization member from the org's developer settings (also available on self-hosted Sentry), and a user auth token, created by an individual user on the User settings > Personal Tokens page — prefer the internal-integration token for a service integration, because it authenticates as the integration rather than as a person.

Least privilege: assign only the scopes the registered capabilities need — project:read and org:read for the reads, event:read for the issue collection read, event:write or event:admin for issue update and issue deletion, and project:admin only where project deletion is enabled.

Expiry and revocation: internal-integration and user tokens do not expire on their own (only OAuth access tokens from the authorization-code flow carry the 30-day expiry described in the retrieved reference, and this pack does not register OAuth), so revocation is explicit deletion of the token in Sentry settings. The reviewed documentation does not establish whether disabling issuance, removing the integration's UI access, or deactivating the creating user invalidates tokens already issued, so the deployment must not rely on any of those mechanisms: each issued token must be deleted individually to guarantee revocation.

An expired or deleted value fails closed with a 401. Rotation therefore sits with an external deployment process: the executor injects the stored value verbatim and performs no token lifecycle of its own. Sentry also documents HTTP Basic auth with a legacy API key as username and an empty password, and DSN-based auth on a small number of endpoints; this pack registers the Bearer header only.

Executor hygiene: the value must live only in executor memory for the lifetime of a call, must never be written to logs, traces or diagnostics, and must not appear in crash dumps; a deployment that cannot meet that bar must not enable the pack.

Resources

  • sentry-org (api, internal): https://sentry-api.invalid/api/0/organizations/ORG
  • sentry-issues (api, pii): https://sentry-api.invalid/api/0/organizations/ORG/issues/

Technical package and review record

Complete provider requirements and exclusions

The endpoint host 'sentry-api.invalid' is a reserved non-production placeholder (an RFC 2606 reserved TLD): substitute the customer's Sentry host — sentry.io for the SaaS (Sentry's documented management-API authority; the regional *.ingest.sentry.io subdomains serve event ingestion only, not this API), or the customer's self-hosted Sentry hostname — before enabling, in every endpoint, in the resource locators and in every egress allowlist entry. The allowlist matches exactly, so endpoints and allowlist must be substituted together, and substitution is a required deployment step. ORG, PROJECT and ISSUE_ID in the endpoint paths are placeholders the deployment binds to the concrete organization slug, project slug and issue id before enabling.

Every read endpoint here is a COLLECTION read: single-record reads (GET an issue, GET a project, GET an organization's details) are not registered.

Approval classification: the issue-update endpoint is judged by effect, not by its PATCH-like name. Per the retrieved Update an Issue reference — rechecked during the documented review against the single-issue operation, whose documented body parameters DO include merge and discard — the caller-controlled body can set status to resolved, ignored or resolvedInNextRelease (a workflow resolution — resolve equivalents sit at R3), can set merge=true (merging issues cannot be unmerged), can set discard=true (which discards the issues instead of updating them, a deletion of the issue and its future matching events), and can set isPublic=true (publishes the issue, and share is one of the designated actions requiring human approval because disclosed information cannot be made private again).

An unrestricted body therefore defeats any tier below R3, and the capability declares update, delete and share at the minimum R3 tier. Issue deletion and project deletion register as delete at the minimum R3 tier; according to the reviewed Delete a Project reference, project deletion is asynchronous — deletion is scheduled, not immediate, and once begun the project is hidden from most public views — so completion timing is not a guarantee of this registration, but the effect is deletion.

Documented exclusions — this pack does not register: the bulk issue-mutation endpoint (PUT /api/0/organizations/{org}/issues/, whose body applies the same merge/discard/resolve effects to many issues at once), event ingestion and the store/DSN endpoints (unmediated event submission), client key (DSN) management, team and organization member management, organization deletion, alert rules and notification settings, release and deploy creation (a deploy record notifies downstream integrations), issue comments and user feedback submission, and every other Sentry API.

Download the complete package JSON for exact network allowlists, credential requirements, exclusions, and setup notes. Read these requirements before installation.

The full documentation review record is supplied in the evaluation package. The evaluation package runs in your environment and comes only with the paid design partnership. This page reproduces the source links and review block; the full record is available for evaluation. Discuss a design partnership to inspect it before installation.

Review block

This section reproduces the review block recorded in the pack file. The evidence and approval record is separate: for a reviewed pack, it is in the evaluation materials and in the release binary's embedded assets.

Review completed: 2026-09-22

8 sources, retrieved 2026-09-21

Current documentation links are navigation aids. They do not change the package, its historical sources or its review date. Review dates describe a documentation review, not a live integration test. No package is provider-endorsed or yet tested against a live provider tenant.

Release identity

SHA-256 of the pack file bytes: b4a2d9d702791d22cd0d84a96c7b6c4d778edda199c83bc80351993168b2f916

Distributable: yes, digest matches the release manifest. Editing a package changes its release identity. A deployment plan checks its own file digests; it does not restore reviewed status or authenticate approval.