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 of the existing external issue to link, as understood by the provider (such as a Jira issue key).

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?