Link an Existing External Issue to an Issue

PUT /api/0/organizations/{organization_id_or_slug}/issues/{issue_id}/integrations/{integration_id}/

Link an issue that already exists in the external provider (such as a Jira ticket or GitHub issue) to the given Sentry issue. Additional accepted fields are integration-specific; fetch them from the linkIssueConfig returned by the GET endpoint with ?action=link.

Path Parameters

organization_id_or_slug (string) REQUIRED: The ID or slug of the organization the resource belongs to.
issue_id (string) REQUIRED: The ID of the issue you'd like to query.
integration_id (string) REQUIRED: The ID of the integration installed on the organization.

Body Parameters

externalIssue (string) REQUIRED: The identifier or full URL of the existing external issue to link. URL support depends on the selected integration.
repo (string): The repository containing the external issue, in owner/name format. Required by GitHub, GitHub Enterprise, and Bitbucket integrations.
comment (string): An optional comment to post to the external issue when linking, if supported by the integration.

Scopes

You need to authenticate via bearer auth token.

<auth_token> requires one of the following scopes:

event:admin
event:write

Copied

curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/issues/{issue_id}/integrations/{integration_id}/ \
 -H 'Authorization: Bearer <auth_token>' \
 -X PUT \
 -H 'Content-Type: application/json' \
 -d '{}'

RESPONSESCHEMA

Copied
{
  "id": 5,
  "key": "PROJECT-123",
  "url": "https://example.atlassian.net/browse/PROJECT-123",
  "integrationId": 123456,
  "displayName": "PROJECT-123"
}

Was this helpful?