# Jira Workflow scheme drafts API

**Canonical:** https://apis.io/apis/jira/jira-workflow-scheme-drafts-api/  
**Provider:** Jira — https://apis.io/providers/jira/  
**Base URL:** https://your-domain.atlassian.net/rest/api/2  
**Documentation:** https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/

Jira Workflow scheme drafts API is one of 132 APIs that [Jira](https://apis.io/providers/jira/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Workflow Scheme Drafts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

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.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| POST | `/rest/api/3/workflowscheme/{id}/createdraft` | Create draft workflow scheme |
| DELETE | `/rest/api/3/workflowscheme/{id}/draft` | Delete draft workflow scheme |
| GET | `/rest/api/3/workflowscheme/{id}/draft` | Get draft workflow scheme |
| PUT | `/rest/api/3/workflowscheme/{id}/draft` | Update draft workflow scheme |
| DELETE | `/rest/api/3/workflowscheme/{id}/draft/default` | Delete draft default workflow |
| GET | `/rest/api/3/workflowscheme/{id}/draft/default` | Get draft default workflow |
| PUT | `/rest/api/3/workflowscheme/{id}/draft/default` | Update draft default workflow |
| DELETE | `/rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType}` | Delete workflow for issue type in draft workflow scheme |
| GET | `/rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType}` | Get workflow for issue type in draft workflow scheme |
| PUT | `/rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType}` | Set workflow for issue type in draft workflow scheme |
| POST | `/rest/api/3/workflowscheme/{id}/draft/publish` | Publish draft workflow scheme |
| DELETE | `/rest/api/3/workflowscheme/{id}/draft/workflow` | Delete issue types for workflow in draft workflow scheme |
| GET | `/rest/api/3/workflowscheme/{id}/draft/workflow` | Get issue types for workflows in draft workflow scheme |
| PUT | `/rest/api/3/workflowscheme/{id}/draft/workflow` | Set issue types for workflow in workflow scheme |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-workflow-scheme-drafts-api-openapi.yml
- **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/

## Other Jira APIs (12)

- [Jira Cloud Platform REST API v2](https://apis.io/apis/jira/jira-cloud-platform-rest-api-v2/)
- [Jira Service Management Operations REST API](https://apis.io/apis/jira/jira-service-management-operations-rest-api/)
- [Jira Align REST API](https://apis.io/apis/jira/jira-align-rest-api/)
- [Jira Customer Service Management REST API](https://apis.io/apis/jira/jira-customer-service-management-rest-api/)
- [Jira Issue Comments API](https://apis.io/apis/jira/jira-issue-comments-api/)
- [Jira Issue Priorities API](https://apis.io/apis/jira/jira-issue-priorities-api/)
- [Jira Issue Search API](https://apis.io/apis/jira/jira-issue-search-api/)
- [Jira Issue Statuses API](https://apis.io/apis/jira/jira-issue-statuses-api/)
- [Jira Issue Transitions API](https://apis.io/apis/jira/jira-issue-transitions-api/)
- [Jira Issue Types API](https://apis.io/apis/jira/jira-issue-types-api/)
- [Jira Issues API](https://apis.io/apis/jira/jira-issues-api/)
- [Jira Projects API](https://apis.io/apis/jira/jira-projects-api/)

## Tags

Workflow Scheme Drafts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/jira/jira-workflow-scheme-drafts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/jira/.