Create or Link an External Issue Through a Sentry App

ExperimentalThis API is under active development and may change.
POST /api/0/sentry-app-installations/{uuid}/external-issue-actions/

Invoke the installed app's issue-link callback and store the returned association. Submit the app-specific form fields alongside groupId, action, and uri.

For action=link, the optional expectedExternalIssueUrl query parameter requires an exact canonical webUrl match. An existing matching link is returned with HTTP 200 without calling the App; a different link returns 409. The callback must also return this URL before a new link is saved. Callback effects cannot be rolled back if its response conflicts. A new association returns HTTP 201. Omitting the parameter preserves the App's existing replacement behavior and HTTP 200 response.

Path Parameters

uuid (string)
REQUIRED

The UUID of the Sentry App installation.

Query Parameters:

expectedExternalIssueUrl (string)

The exact canonical webUrl of the external issue to link. Only supported for action=link. An existing matching association is a no-op; a different association or callback URL returns 409 without replacing the link.

Body Parameters

groupId (string)
REQUIRED

The numeric Sentry issue ID.

action (string)
REQUIRED

The action to perform: link or create.

uri (string)
REQUIRED

The relative callback URI from the app's issue-link form.

Scopes

<auth_token> requires one of the following scopes:
  • event:admin
  • event:write
Copied
curl https://sentry.io/api/0/sentry-app-installations/{uuid}/external-issue-actions/ \
 -H 'Authorization: Bearer <auth_token>' \
 -H 'Content-Type: application/json' \
 -d '{}'
RESPONSESCHEMA
Copied
.
Was this helpful?