# Jira Workflows API

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

This resource represents workflows. Use it to: * Get workflows * Create workflows * Update workflows * Delete inactive workflows * Get workflow capabilities

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/rest/api/3/workflow/history` | Read workflow version from history |
| POST | `/rest/api/3/workflow/history/list` | List workflow history entries |
| GET | `/rest/api/3/workflow/search` | Get workflows paginated |
| DELETE | `/rest/api/3/workflow/{entityId}` | Delete inactive workflow |
| GET | `/rest/api/3/workflow/{workflowId}/project/{projectId}/issueTypeUsages` | Get issue types in a project that are using a given workflow |
| GET | `/rest/api/3/workflow/{workflowId}/projectUsages` | Get projects using a given workflow |
| GET | `/rest/api/3/workflow/{workflowId}/workflowSchemes` | Get workflow schemes which are using a given workflow |
| POST | `/rest/api/3/workflows` | Bulk get workflows |
| GET | `/rest/api/3/workflows/capabilities` | Get available workflow capabilities |
| POST | `/rest/api/3/workflows/create` | Bulk create workflows |
| POST | `/rest/api/3/workflows/create/validation` | Validate create workflows |
| GET | `/rest/api/3/workflows/defaultEditor` | Get the user's default workflow editor |
| POST | `/rest/api/3/workflows/preview` | Preview workflow |
| GET | `/rest/api/3/workflows/search` | Search workflows |
| POST | `/rest/api/3/workflows/update` | Bulk update workflows |
| POST | `/rest/api/3/workflows/update/validation` | Validate update workflows |

## Machine-readable artifacts (6)

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

Workflows

---

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