Jira

Jira Workflow schemes API

This resource represents workflow schemes. Use it to manage workflow schemes and the workflow scheme's workflows and issue types. A workflow scheme maps issue types to workflows. A workflow scheme can be associated with one or more projects, which enables the projects to use the workflow-issue type mappings. Active workflow schemes (workflow schemes that are used by projects) cannot be edited. When an active workflow scheme is edited, a draft copy of the scheme is created. The draft workflow scheme is then be edited and published (replacing the active scheme). See [Configuring workflow schemes](https://confluence.atlassian.com/x/tohKLg) for more information.

GitHub OpenAPI

Operations 19

GET /rest/api/3/workflowscheme Get all workflow schemes #
POST /rest/api/3/workflowscheme Create workflow scheme #
POST /rest/api/3/workflowscheme/project/switch Switch workflow scheme for project #
POST /rest/api/3/workflowscheme/read Bulk get workflow schemes #
POST /rest/api/3/workflowscheme/update Update workflow scheme #
POST /rest/api/3/workflowscheme/update/mappings Get required status mappings for workflow scheme update #
DELETE /rest/api/3/workflowscheme/{id} Delete workflow scheme #
GET /rest/api/3/workflowscheme/{id} Get workflow scheme #
PUT /rest/api/3/workflowscheme/{id} Classic update workflow scheme #
DELETE /rest/api/3/workflowscheme/{id}/default Delete default workflow #
GET /rest/api/3/workflowscheme/{id}/default Get default workflow #
PUT /rest/api/3/workflowscheme/{id}/default Update default workflow #
DELETE /rest/api/3/workflowscheme/{id}/issuetype/{issueType} Delete workflow for issue type in workflow scheme #
GET /rest/api/3/workflowscheme/{id}/issuetype/{issueType} Get workflow for issue type in workflow scheme #
PUT /rest/api/3/workflowscheme/{id}/issuetype/{issueType} Set workflow for issue type in workflow scheme #
DELETE /rest/api/3/workflowscheme/{id}/workflow Delete issue types for workflow in workflow scheme #
GET /rest/api/3/workflowscheme/{id}/workflow Get issue types for workflows in workflow scheme #
PUT /rest/api/3/workflowscheme/{id}/workflow Set issue types for workflow in workflow scheme #
GET /rest/api/3/workflowscheme/{workflowSchemeId}/projectUsages Get projects which are using a given workflow scheme #

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-workflow-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-workflow-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-workflow-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 Workflow schemes API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


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