Jira

Jira Issue Types API

Retrieve and manage issue types for projects.

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 /issuetype List issue types via the legacy unversioned path · Jira Get All Issue Types for User #
Ask an LLM
“Is there an older unversioned endpoint that lists the issue types visible to me?”
“What does the legacy /issuetype path return for my user?”
Tell an agent
Use the legacy unversioned issuetype path to list issue types I can see.
Call the older /issuetype endpoint for my visible issue types.
GET /rest/api/3/issuetype List all issue types via REST API v3 · Get all issue types for user #
Ask an LLM
“Which issue types exist across the Jira site in the v3 API?”
“Why do I see fewer issue types than a Jira admin does?”
Tell an agent
List all issue types using the v3 REST API.
Get every issue type available to me from /rest/api/3/issuetype.
POST /rest/api/3/issuetype Create an issue type · Create issue type #
Ask an LLM
“How do I add a new issue type to Jira?”
“Can I create a subtask-level issue type?”
Tell an agent
Create an issue type called {name}.
Create issue type {name} at hierarchy level {hierarchyLevel} described as {description}.
GET /rest/api/3/issuetype/project List issue types for a project · Get issue types for project #
Ask an LLM
“Which issue types can be used in a particular project?”
“Can I list only the epic-level issue types in a project?”
Tell an agent
List the issue types for project {projectId}.
Show issue types at level {level} in project {projectId}.
DELETE /rest/api/3/issuetype/{id} Delete an issue type · Delete issue type #
Ask an LLM
“How do I delete an issue type that's still used by issues?”
“What happens to existing issues when their issue type is deleted?”
Tell an agent destructive · confirm first
Delete issue type {id}.
Delete issue type {id} and move its issues to issue type {alternativeIssueTypeId}.
GET /rest/api/3/issuetype/{id} Get one issue type · Get issue type #
Ask an LLM
“What are the details of a specific issue type by ID?”
“Is a given issue type a subtask or a standard type?”
Tell an agent
Get issue type {id}.
Show the name, description and hierarchy level of issue type {id}.
PUT /rest/api/3/issuetype/{id} Update an issue type · Update issue type #
Ask an LLM
“How do I rename an issue type or change its avatar?”
“Is there a length limit on an issue type's name?”
Tell an agent
Rename issue type {id} to {name}.
Set the avatar of issue type {id} to avatar {avatarId}.
GET /rest/api/3/issuetype/{id}/alternatives List replacement issue types for an issue type · Get alternative issue types #
Ask an LLM
“Which issue types could replace one I plan to delete?”
“What issue types share the same workflow, field and screen schemes as this one?”
Tell an agent
List alternative issue types for issue type {id}.
Show which issue types can take over for issue type {id}.
POST /rest/api/3/issuetype/{id}/avatar2 Upload an avatar image for an issue type · Load issue type avatar #
Ask an LLM
“How do I upload a custom icon for an issue type?”
“Which image formats can an issue type avatar use, and can I crop it?”
Tell an agent
Upload this image as the avatar for issue type {id}, cropped to {size} pixels.
Load an issue type avatar for {id} cropping a {size} square from x {x} and y {y}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
RateLimits
https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/platform/getting-started/
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
📖
Authentication
https://developer.atlassian.com/cloud/jira/software/security-overview/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-types-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/asyncapi/jira-webhooks-asyncapi.yml

Code Examples

💻
CodeExamples
https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples

Other Resources

🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/platform/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/platform/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/software/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/software/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/service-desk/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/service-desk/security-overview/

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-issue-types-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-issue-types-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Jira Issue Types API
  x-refined-note:
  - x-atlassian-api-version differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Issue Types across 2 of this provider''s published API definitions: jira-cloud-platform-rest-api-openapi.yml, jira-platform-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{domain}.atlassian.net/rest/api/3
  description: Jira Cloud instance
  variables:
    domain:
      description: Your Jira Cloud site subdomain (e.g., your-company).
      default: your-domain
- url: https://your-domain.atlassian.net
tags:


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