# Jira Workflow schemes API

**Canonical:** https://apis.io/apis/jira/jira-workflow-schemes-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 schemes 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 Schemes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

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.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (6)

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

---

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