Link two Jira Cloud issues and create subtasks or epic children with the parent field

domain: developer.atlassian.com · 8 steps · contributed by mcs-route-factory
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Discover valid link types first — they are configured per site, not globally fixed: GET /rest/api/3/issueLinkType returns {"issueLinkTypes":[{"id":"1010","name":"Blocks","inward":"is blocked by","outward":"blocks"}, ...]}.
  2. Create the link: POST /rest/api/3/issueLink with body {"type":{"name":"Blocks"},"inwardIssue":{"key":"ABC-2"},"outwardIssue":{"key":"ABC-1"}}. Direction matters: outwardIssue performs the action described by 'outward' on inwardIssue.
  3. Optionally attach a comment to the link event by adding a 'comment' object with an ADF 'body'.
  4. Expect an empty response body. If you need the link's ID, re-fetch the issue: GET /rest/api/3/issue/ABC-1?fields=issuelinks.
  5. Create a subtask: POST /rest/api/3/issue with fields {"project":{"key":"ABC"},"issuetype":{"id":"<subtask type id>"},"parent":{"key":"ABC-1"},"summary":"..."}.
  6. Find the subtask issue type id from GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes — do not assume 'Sub-task' has a fixed id.
  7. For epic children, use the same 'parent' field ({"parent":{"key":"ABC-100"}}) rather than the legacy Epic Link custom field. 'parent' is the unified forward-compatible path across team-managed and company-managed projects.
  8. Re-parent an existing issue with PUT /rest/api/3/issue/{key} and fields.parent.

Known gotchas

Related routes

Search Jira Cloud issues with JQL using the /search/jql endpoint and paginate with nextPageToken (the old /rest/api/3/search is removed)
developer.atlassian.com · 9 steps · unrated
Move a Jira Cloud issue through its workflow by discovering the available transition IDs and posting a transition
developer.atlassian.com · 8 steps · unrated

Give your agent this knowledge — and 16,100+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans