Jira

Jira Epic API

Apis related to epics

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/agile/1.0/epic/none/issue List issues not in any epic · Get issues without epic #
Ask an LLM
“Which issues don't belong to any epic yet?”
“Can I filter the issues without an epic using JQL?”
Tell an agent
List issues that aren't in an epic.
Show epic-less issues matching {jql}.
POST /rest/agile/1.0/epic/none/issue Remove issues from their epics · Remove issues from epic #
Ask an LLM
“How do I take issues out of whatever epic they're in?”
“How many issues can I remove from epics in one call?”
Tell an agent
Remove issues {issues} from their epics.
Detach {issues} so they belong to no epic.
GET /rest/software/1.0/epic/none/issue List issues without an epic, token paged · Get issues without epic (enhanced) #
Ask an LLM
“Is there a token-paged way to list issues that have no epic?”
“Can I get epic-less issues with reconciled results using nextPageToken?”
Tell an agent
List issues with no epic via the enhanced endpoint.
Get the next page of epic-less issues using token {nextPageToken}.
GET /rest/agile/1.0/epic/{epicIdOrKey} Get an epic · Get epic #
Ask an LLM
“How do I look up an epic's name, summary and done status?”
“Can I fetch an epic by its key?”
Tell an agent
Show epic {epicIdOrKey}.
Check whether epic {epicIdOrKey} is marked done.
POST /rest/agile/1.0/epic/{epicIdOrKey} Update an epic's name, summary, color or status · Partially update epic #
Ask an LLM
“How do I rename an epic or change its color?”
“Can I mark an epic as done through the agile API?”
Tell an agent
Rename epic {epicIdOrKey} to {name}.
Set the color of epic {epicIdOrKey} to {color}.
GET /rest/agile/1.0/epic/{epicIdOrKey}/issue List issues in an epic · Get issues for epic #
Ask an LLM
“Which issues belong to a given epic?”
“Can I filter an epic's child issues with JQL?”
Tell an agent
List the issues in epic {epicIdOrKey}.
Show issues in epic {epicIdOrKey} matching {jql}.
POST /rest/agile/1.0/epic/{epicIdOrKey}/issue Move issues into an epic · Move issues to epic #
Ask an LLM
“How do I add existing issues to an epic?”
“If an issue is already in another epic, what happens when I move it?”
Tell an agent
Move issues {issues} into epic {epicIdOrKey}.
Add {issues} to epic {epicIdOrKey}.
GET /rest/software/1.0/epic/{epicIdOrKey}/issue List an epic's issues with token paging · Get issues for epic (enhanced) #
Ask an LLM
“Is there an enhanced epic issues listing that pages with nextPageToken?”
“Can I get an epic's issues with reconciled search results?”
Tell an agent
List issues in epic {epicIdOrKey} using the enhanced token-paged endpoint.
Get the next page of epic {epicIdOrKey} issues with token {nextPageToken}.
PUT /rest/agile/1.0/epic/{epicIdOrKey}/rank Rank an epic before or after another · Rank epics #
Ask an LLM
“How do I reorder epics on my board?”
“Can I move one epic above another in rank?”
Tell an agent
Rank epic {epicIdOrKey} before epic {rankBeforeEpic}.
Move epic {epicIdOrKey} after {rankAfterEpic}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-epic-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-epic-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-epic-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    url: https://getsupport.atlassian.com
  description: Jira Software Cloud REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://atlassian.com/terms/
  title: Jira Software Cloud Epic API
  version: 1001.0.0
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (101 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-epic-api-openapi.yml