v4

latestOpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB

Issue remote links

Update remote issue link by ID

Updates a remote issue link for an issue.

Note: Fields without values in the request are set to null.

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.

put/rest/api/3/issue/{issueIdOrKey}/remotelink/{linkId}

Path parameters

issueIdOrKeystring required

Example:10000

The ID or key of the issue.

linkIdstring required

Example:10000

The ID of the remote issue link.

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 request is successful.

{"stackTrail":"paths:/rest/api/3/issue/{issueIdOrKey}/remotelink/{linkId}:put:responses:204:content:application/json:schema","oasType":"schema","type":"unknown"}