Set issue types for workflow in workflow scheme

PUT

/rest/api/3/workflowscheme/{id}/workflow

Sets the issue types for a workflow in a workflow scheme. The workflow can also be set as the default workflow for the workflow scheme. Unmapped issues types are mapped to the default workflow.

Note that active workflow schemes cannot be edited. If the workflow scheme is active, set updateDraftIfNeeded to true in the request body and a draft workflow scheme is created or updated with the new workflow-issue types mappings. The draft workflow scheme can be published in Jira.

Permissions required: Administer Jira global permission.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/workflowscheme//workflow?workflowName' \
--header 'Content-Type: application/json' \
--data-raw '{
    "issueTypes": [
        "10000"
    ],
    "updateDraftIfNeeded": true,
    "workflow": "jira"
}'

Response Example

{"defaultWorkflow":"jira","description":"The description of the example workflow scheme.","draft":false,"id":101010,"issueTypeMappings":{"10000":"scrum workflow","10001":"builds workflow"},"name":"Example workflow scheme","self":"https://your-domain.atlassian.net/rest/api/3/workflowscheme/101010"}

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

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

Get issue types for workflows in workflow scheme

Get projects which are using a given workflow scheme