Get required status mappings for workflow scheme update

POST

/rest/api/3/workflowscheme/update/mappings

Gets the required status mappings for the desired changes to a workflow scheme. The results are provided per issue type and workflow. When updating a workflow scheme, status mappings can be provided per issue type, per workflow, or both.

Permissions required:

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

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/workflowscheme/update/mappings' \
--header 'Content-Type: application/json' \
--data-raw '{
    "defaultWorkflowId": "10010",
    "id": "10001",
    "workflowsForIssueTypes": [
        {
            "issueTypeIds": [
                "10010",
                "10011"
            ],
            "workflowId": "10001"
        }
    ]
}'

Response Example

{"statusMappingsByIssueTypes":[{"issueTypeId":"10000","statusIds":["10000","10001"]}],"statusMappingsByWorkflows":[{"sourceWorkflowId":"10000","statusIds":["10000","10001"],"targetWorkflowId":"10001"}],"statuses":[{"category":"TODO","id":"10000","name":"To Do"}],"statusesPerWorkflow":[{"initialStatusId":"10000","statuses":["10000","10001"],"workflowId":"10000"}]}

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

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

Update workflow scheme

Delete workflow scheme