---
title: "Switch workflow scheme for project"
method: POST
path: "/rest/api/3/workflowscheme/project/switch"
tags: ["Workflow schemes"]
---

# Switch workflow scheme for project

`POST /rest/api/3/workflowscheme/project/switch`

Switches a workflow scheme for a project.

Workflow schemes can only be assigned to classic projects.

**Calculating required mappings:** If statuses from the current workflow scheme won't exist in the target workflow scheme, you must provide `mappingsByIssueTypeOverride` to specify how issues with those statuses should be migrated. Use [the required workflow scheme mappings API](#api-rest-api-3-workflowscheme-update-mappings-post) to determine which statuses and issue types require mappings.

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

## Request body

- WorkflowSchemeProjectSwitchBean — Request to switch a project's workflow scheme
  - `mappingsByIssueTypeOverride` MappingsByIssueTypeOverride[] — The mappings for migrating issues from old statuses to new statuses when switching from one workflow scheme to another. This field is required if any statuses in the current project's workflows would no longer exist in the target workflow scheme. Each mapping defines how to update issues from an old status to the corresponding new status in the issue’s new workflow.
    - `issueTypeId` string
    - `statusMappings` WorkflowAssociationStatusMapping[]
      - `newStatusId` string
      - `oldStatusId` string
  - `projectId` string — The ID of the project to switch the workflow scheme for
  - `targetSchemeId` string — The ID of the target workflow scheme to switch to

## Other responses

- `303` — Returned if the request is successful and the task has been started.
- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing, or the caller doesn't have permissions to perform the operation.
- `409` — Returned if a conflicting task is already running.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)