Jira

Jira Issue type schemes API

This resource represents issue type schemes in classic projects. Use it to: * get issue type schemes and a list of the projects that use them. * associate issue type schemes with projects. * add issue types to issue type schemes. * delete issue types from issue type schemes. * create, update, and delete issue type schemes. * change the order of issue types in issue type schemes.

GitHub OpenAPI

Operations 10

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/api/3/issuetypescheme List issue type schemes · Get all issue type schemes #
Ask an LLM
“What issue type schemes exist for our classic projects?”
“Can I search issue type schemes by part of their name?”
Tell an agent
List all issue type schemes.
Find issue type schemes whose name contains {queryString}.
POST /rest/api/3/issuetypescheme Create an issue type scheme · Create issue type scheme #
Ask an LLM
“How do I create a new issue type scheme with a chosen set of issue types?”
“Does a new issue type scheme need at least one standard issue type?”
Tell an agent
Create an issue type scheme named {name} with issue types {issueTypeIds}.
Create issue type scheme {name} containing {issueTypeIds} with {defaultIssueTypeId} as the default.
GET /rest/api/3/issuetypescheme/mapping List the issue types inside issue type schemes · Get issue type scheme items #
Ask an LLM
“Which issue types belong to each issue type scheme?”
“Can I see the issue type members of just certain schemes?”
Tell an agent
List the issue type items in every issue type scheme.
Show which issue types are in issue type scheme {issueTypeSchemeId}.
GET /rest/api/3/issuetypescheme/project Find the issue type scheme used by projects · Get issue type schemes for projects #
Ask an LLM
“Which issue type scheme is a given project using?”
“What issue type schemes are assigned to these projects?”
Tell an agent
Get the issue type scheme used by project {projectId}.
Show the issue type schemes for projects {projectId} and the projects that share each.
PUT /rest/api/3/issuetypescheme/project Assign an issue type scheme to a project · Assign issue type scheme to project #
Ask an LLM
“How do I switch a classic project to a different issue type scheme?”
“Why would assigning an issue type scheme to a project fail?”
Tell an agent
Assign issue type scheme {issueTypeSchemeId} to project {projectId}.
Switch project {projectId} over to issue type scheme {issueTypeSchemeId}.
DELETE /rest/api/3/issuetypescheme/{issueTypeSchemeId} Delete an issue type scheme · Delete issue type scheme #
Ask an LLM
“How do I delete an issue type scheme we no longer need?”
“Can I delete an issue type scheme that's still attached to a project?”
Tell an agent destructive · confirm first
Delete issue type scheme {issueTypeSchemeId}.
Remove the unused issue type scheme {issueTypeSchemeId}.
PUT /rest/api/3/issuetypescheme/{issueTypeSchemeId} Update an issue type scheme's details · Update issue type scheme #
Ask an LLM
“How do I rename an issue type scheme or change its default issue type?”
“Can I edit an issue type scheme's description?”
Tell an agent
Rename issue type scheme {issueTypeSchemeId} to {name}.
Set the default issue type of scheme {issueTypeSchemeId} to {defaultIssueTypeId}.
PUT /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype Add issue types to an issue type scheme · Add issue types to issue type scheme #
Ask an LLM
“How do I add more issue types to an existing issue type scheme?”
“What happens if one of the issue types I add is already in the scheme?”
Tell an agent
Add issue types {issueTypeIds} to issue type scheme {issueTypeSchemeId}.
Append issue types {issueTypeIds} to the end of scheme {issueTypeSchemeId}.
PUT /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype/move Reorder issue types in a scheme · Change order of issue types #
Ask an LLM
“Can I change the order issue types appear in within an issue type scheme?”
“Is it possible to move issue types to a specific position in a scheme?”
Tell an agent
Move issue types {issueTypeIds} after issue type {after} in scheme {issueTypeSchemeId}.
Move issue types {issueTypeIds} to the {position} of scheme {issueTypeSchemeId}.
DELETE /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype/{issueTypeId} Remove an issue type from a scheme · Remove issue type from issue type scheme #
Ask an LLM
“How do I take one issue type out of an issue type scheme?”
“Why can't I remove an issue type that issues are still using from its scheme?”
Tell an agent destructive · confirm first
Remove issue type {issueTypeId} from issue type scheme {issueTypeSchemeId}.
Drop issue type {issueTypeId} out of scheme {issueTypeSchemeId}.

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-issue-type-schemes-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-issue-type-schemes-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-type-schemes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Issue type schemes API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


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