Skip to main content

Link Issues

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.

External Documentation

To learn more, visit the Jira documentation.

Parameters

ParameterDescription
Inward Issue KeyThe ID of the first issue to link. Can be retrieved form the 'List Issues' action.
Outward Issue KeyThe ID of the second issue to link. Can be retrieved form the 'List Issues' action.
Type NameDefines and reports on issue link types. Can be retrieved from the 'List Issue Link Types' action.

Workflow Library Example

Link Issues with Jira and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop