---
title: "Publish draft workflow scheme"
method: POST
path: "/rest/api/3/workflowscheme/{id}/draft/publish"
tags: ["Workflow scheme drafts"]
---

# Publish draft workflow scheme

`POST /rest/api/3/workflowscheme/{id}/draft/publish`

Publishes a draft workflow scheme.

Where the draft workflow includes new workflow statuses for an issue type, mappings are provided to update issues with the original workflow status to the new workflow status.

This operation is [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-rest-api-3-task-taskId-get) to obtain updates.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `id` integer, required

## Query parameters

- `validateOnly` boolean

## Request body

- PublishDraftWorkflowScheme — Details about the status mappings for publishing a draft workflow scheme.
  - `statusMappings` StatusMapping[] — Mappings of statuses to new statuses for issue types.
    - `issueTypeId` string, required — The ID of the issue type.
    - `newStatusId` string, required — The ID of the new status.
    - `statusId` string, required — The ID of the status.

## Response `204`

Returned if the request is only for validation and is successful.

## Other responses

- `303` — Returned if the request is successful.
- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.
- `404` — Returned if any of these are true: * The workflow scheme is not found. * The workflow scheme does not have a draft. * A new status in the draft workflow scheme is not found.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/2783f5d3849c/schema)