Update workflow scheme

POST

/rest/api/3/workflowscheme/update

Updates company-managed and team-managed project workflow schemes. This API doesn't have a concept of draft, so any changes made to a workflow scheme are immediately available. When changing the available statuses for issue types, an asynchronous task migrates the issues as defined in the provided mappings.

Permissions required:

Administer Jira project permission to update all, including global-scoped, workflow schemes.

Administer projects project permission to update project-scoped workflow schemes.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful and there is no asynchronous task.

Body

🔵303303

🟠400Bad Request

🟠401Unauthorized

🟠409409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/workflowscheme/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "defaultWorkflowId": "3e59db0f-ed6c-47ce-8d50-80c0c4572677",
    "description": "description",
    "id": "10000",
    "name": "name",
    "statusMappingsByIssueTypeOverride": [
        {
            "issueTypeId": "10001",
            "statusMappings": [
                {
                    "newStatusId": "2",
                    "oldStatusId": "1"
                },
                {
                    "newStatusId": "4",
                    "oldStatusId": "3"
                }
            ]
        },
        {
            "issueTypeId": "10002",
            "statusMappings": [
                {
                    "newStatusId": "4",
                    "oldStatusId": "1"
                },
                {
                    "newStatusId": "2",
                    "oldStatusId": "3"
                }
            ]
        }
    ],
    "statusMappingsByWorkflows": [
        {
            "newWorkflowId": "3e59db0f-ed6c-47ce-8d50-80c0c4572677",
            "oldWorkflowId": "3e59db0f-ed6c-47ce-8d50-80c0c4572677",
            "statusMappings": [
                {
                    "newStatusId": "2",
                    "oldStatusId": "1"
                },
                {
                    "newStatusId": "4",
                    "oldStatusId": "3"
                }
            ]
        }
    ],
    "version": {
        "id": "527213fc-bc72-400f-aae0-df8d88db2c8a",
        "versionNumber": 1
    },
    "workflowsForIssueTypes": [
        {
            "issueTypeIds": [
                "10000",
                "10003"
            ],
            "workflowId": "3e59db0f-ed6c-47ce-8d50-80c0c4572677"
        },
        {
            "issueTypeIds": [
                "10001`",
                "10002"
            ],
            "workflowId": "3f83dg2a-ns2n-56ab-9812-42h5j1461629"
        }
    ]
}'

Response Example

200 - Example 1

null

Modified at 2025-07-16 07:18:01

Bulk get workflow schemes

Get required status mappings for workflow scheme update