Jira

Jira Workflow scheme drafts API

This resource represents draft workflow schemes. Use it to manage drafts of workflow schemes. 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. Editing an active workflow scheme creates a draft copy of the scheme. The draft workflow scheme can 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 14

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

POST /rest/api/3/workflowscheme/{id}/createdraft Create a draft copy of an active workflow scheme · Create draft workflow scheme #
Ask an LLM
“How do I start a draft of an active workflow scheme so I can edit it safely?”
“Can an active workflow scheme have more than one draft?”
Tell an agent
Create a draft from active workflow scheme {id}.
Copy workflow scheme {id} into a new draft for editing.
DELETE /rest/api/3/workflowscheme/{id}/draft Discard a draft workflow scheme · Delete draft workflow scheme #
Ask an LLM
“How do I throw away unpublished changes to a workflow scheme?”
“Can I delete a workflow scheme's draft without touching the active scheme?”
Tell an agent destructive · confirm first
Delete the draft of workflow scheme {id}.
Discard all pending draft changes on workflow scheme {id}.
GET /rest/api/3/workflowscheme/{id}/draft Get the draft of a workflow scheme · Get draft workflow scheme #
Ask an LLM
“What pending changes are in the draft of an active workflow scheme?”
“Does a given workflow scheme currently have a draft?”
Tell an agent
Get the draft for workflow scheme {id}.
Show the unpublished draft of workflow scheme {id}.
PUT /rest/api/3/workflowscheme/{id}/draft Update a draft workflow scheme · Update draft workflow scheme #
Ask an LLM
“How do I rename or re-describe the draft of a workflow scheme?”
“Will updating a draft create one if the scheme has no draft yet?”
Tell an agent
Rename the draft of workflow scheme {id} to {name}.
Set the draft of workflow scheme {id} to default workflow {defaultWorkflow} with mappings {issueTypeMappings}.
DELETE /rest/api/3/workflowscheme/{id}/draft/default Reset a draft's default workflow to the system one · Delete draft default workflow #
Ask an LLM
“How do I reset a draft scheme's default workflow back to Jira's system workflow?”
“What becomes the default workflow if I clear it in a draft?”
Tell an agent destructive · confirm first
Reset the default workflow in the draft of scheme {id} to the system workflow.
Clear the custom default workflow from workflow scheme {id}'s draft.
GET /rest/api/3/workflowscheme/{id}/draft/default Get the default workflow in a scheme's draft · Get draft default workflow #
Ask an LLM
“Which workflow handles unmapped issue types in a draft workflow scheme?”
“What is the default workflow set in my scheme's draft?”
Tell an agent
Get the default workflow of the draft for workflow scheme {id}.
Show which workflow covers all unassigned issue types in scheme {id}'s draft.
PUT /rest/api/3/workflowscheme/{id}/draft/default Set the default workflow in a scheme's draft · Update draft default workflow #
Ask an LLM
“How do I change the default workflow in a draft workflow scheme?”
“Can setting the draft's default workflow create the draft automatically?”
Tell an agent
Set {workflow} as the default workflow in the draft of scheme {id}.
Make {workflow} the fallback for unmapped issue types in workflow scheme {id}'s draft.
DELETE /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} Remove an issue type's mapping from a draft · Delete workflow for issue type in draft workflow scheme #
Ask an LLM
“How do I unmap one issue type from its workflow in a draft scheme?”
“What happens to an issue type after I remove its draft workflow mapping?”
Tell an agent destructive · confirm first
Remove the workflow mapping for issue type {issueType} from the draft of scheme {id}.
Unmap issue type {issueType} in workflow scheme {id}'s draft.
GET /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} Get the workflow for an issue type in a draft · Get workflow for issue type in draft workflow scheme #
Ask an LLM
“Which workflow is a specific issue type mapped to in a draft workflow scheme?”
“In the draft scheme, what workflow will bugs follow?”
Tell an agent
Get the workflow mapped to issue type {issueType} in the draft of scheme {id}.
Show which draft workflow issue type {issueType} uses in workflow scheme {id}.
PUT /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} Map an issue type to a workflow in a draft · Set workflow for issue type in draft workflow scheme #
Ask an LLM
“How do I assign a different workflow to one issue type in a draft scheme?”
“Can I change a single issue type's workflow without publishing yet?”
Tell an agent
In the draft of scheme {id}, map issue type {issueType} to workflow {workflow}.
Set draft workflow {workflow} for issue type {issueType} on workflow scheme {id}.
POST /rest/api/3/workflowscheme/{id}/draft/publish Publish a draft workflow scheme · Publish draft workflow scheme #
Ask an LLM
“How do I make my draft workflow scheme changes live?”
“Can I validate a draft publish first without applying it?”
Tell an agent
Publish the draft of workflow scheme {id}.
Publish scheme {id}'s draft, moving issues with status mappings {statusMappings}.
DELETE /rest/api/3/workflowscheme/{id}/draft/workflow Remove a workflow's mappings from a draft · Delete issue types for workflow in draft workflow scheme #
Ask an LLM
“How do I drop a whole workflow from a draft workflow scheme?”
“Where do issue types go when I remove their workflow from the draft?”
Tell an agent destructive · confirm first
Remove workflow {workflowName} and its issue type mappings from the draft of scheme {id}.
Drop workflow {workflowName} from workflow scheme {id}'s draft.
GET /rest/api/3/workflowscheme/{id}/draft/workflow List workflow-to-issue-type mappings in a draft · Get issue types for workflows in draft workflow scheme #
Ask an LLM
“Which issue types does each workflow cover in a draft scheme?”
“Can I limit draft mappings to just one workflow by name?”
Tell an agent
List all workflow to issue type mappings in the draft of scheme {id}.
Show which issue types workflow {workflowName} covers in scheme {id}'s draft.
PUT /rest/api/3/workflowscheme/{id}/draft/workflow Set the issue types for a workflow in a draft · Set issue types for workflow in workflow scheme #
Ask an LLM
“How do I assign a list of issue types to one workflow in a draft scheme?”
“Can I make a workflow the draft default while setting its issue types?”
Tell an agent
In the draft of scheme {id}, assign issue types {issueTypes} to workflow {workflowName}.
Make workflow {workflowName} the default in scheme {id}'s draft: defaultMapping {defaultMapping}.

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


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