Link issues
jira_link_issuesLink two Jira issues using a specified link type, with direction controlling which issue blocks or is blocked by the other. Optionally add a comment to the inward issue.
Instructions
Link two issues. linkType is the link type NAME ("Blocks", "Relates"), and those names are instance-specific — read them from jira_list_link_types and spell them exactly. Direction matters: outwardIssue is the issue that acts (blocks), inwardIssue the one acted on (is blocked by). comment is added to the inward issue alongside the link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"linkType": "<linkType>",
"inwardIssue": "<inwardIssue>",
"outwardIssue": "<outwardIssue>"
},
"name": "jira_link_issues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply | No | Set true to EXECUTE this write. Omit (or false) to get a plan of the request that would be sent. Executing also requires the server to run with JIRA_WRITE_MODE=apply. | |
| format | No | How to interpret a string rich-text input: "text" (default — blank lines split paragraphs, single newlines are hard breaks) or "markdown" (the documented subset: headings, lists, code fences, bold/italic/code, links). Refused alongside a raw ADF document. | |
| comment | No | Comment added to the inward issue alongside the link; text or ADF. | |
| plan_id | No | The single-use id returned by the preceding plan-mode call. Required together with apply: true; a mismatch means the arguments changed since the plan, and the write is refused rather than executed. | |
| profile | No | Named credential profile for this call. Omit to use the active profile. Rejected when the server locks the profile (JIRA_LOCK_PROFILE). | |
| linkType | Yes | Link type NAME (Blocks, Relates). See jira_list_link_types. | |
| inwardIssue | Yes | The issue at the inward end — the one "is blocked by". | |
| outwardIssue | Yes | The issue at the outward end — the one that "blocks". |