Create issue link

Creates a link between two issues. Use this operation to indicate a relationship between two issues and optionally add a comment to the from (outward) issue. To use this resource the site must have Issue Linking enabled.

This resource returns nothing on the creation of an issue link. To obtain the ID of the issue link, use https://your-domain.atlassian.net/rest/api/3/issue/[linked issue key]?fields=issuelinks.

If the link request duplicates a link, the response indicates that the issue link was created. If the request included a comment, the comment is added.

This operation can be accessed anonymously.

Permissions required:

Browse project project permission for all the projects containing the issues to be linked,

Link issues project permission on the project containing the from (outward) issue,

If issue-level security is configured, issue-level security permission to view the issue.

If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to.

curl --location --request POST '/rest/api/3/issueLink' \ --header 'Content-Type: application/json' \ --data-raw '{ "comment": { "body": { "content": [ { "content": [ { "text": "Linked related issue!", "type": "text" } ], "type": "paragraph" } ], "type": "doc", "version": 1 }, "visibility": { "identifier": "276f955c-63d7-42c8-9520-92d01dca0625", "type": "group", "value": "jira-software-users" } }, "inwardIssue": { "key": "HSP-1" }, "outwardIssue": { "key": "MKY-1" }, "type": { "name": "Duplicate" } }'

Create issue link

Request

Responses