v4

latestOpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB

Issue remote links

Create or update remote issue link

Creates or updates a remote issue link for an issue.

If a globalId is provided and a remote issue link with that global ID is found it is updated. Any fields without values in the request are set to null. Otherwise, the remote issue link is created.

This operation requires issue linking to be active.

This operation can be accessed anonymously.

Permissions required:

Browse projects and Link issues project permission for the project that the issue is in.
If issue-level security is configured, issue-level security permission to view the issue.

post/rest/api/3/issue/{issueIdOrKey}/remotelink

Path parameters

issueIdOrKeystring required

The ID or key of the issue.

Request body

globalIdstring

An identifier for the remote item in the remote system. For example, the global ID for a remote item in Confluence would consist of the app ID and page ID, like this: appId=456&pageId=123.

Setting this field enables the remote issue link details to be updated or deleted using remote system and item details as the record identifier, rather than using the record's Jira ID.

The maximum length is 255 characters.

relationshipstring

Description of the relationship between the issue and the linked item. If not set, the relationship description "links to" is used in Jira.

Response

Returned if the remote issue link is updated.

idinteger

The ID of the remote issue link, such as the ID of the item on the remote system.

selfstring

The URL of the remote issue link.