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 -g --request POST 'http:///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" } }'

返回响应

🟢201Returned if the request is successful.

application/json

Body

🟠400Returned if the comment is not created. The response contains an error message indicating why the comment wasn't created. The issue link is also not created.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠404Returned if: * issue linking is disabled. * the user cannot view one or both of the issues. For example, the user doesn't have *Browse project* project permission for a project containing one of the issues. * the user does not have *link issues* pr

请求参数

返回响应