Update workflow scheme

Updates a workflow scheme, including the name, default workflow, issue type to project mappings, and more. If the workflow scheme is active (that is, being used by at least one project), then a draft workflow scheme is created or updated instead, provided that updateDraftIfNeeded is set to true.

Permissions required: Administer Jira global permission.

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/workflowscheme/' \ --header 'Content-Type: application/json' \ --data-raw '{ "defaultWorkflow": "jira", "description": "The description of the example workflow scheme.", "issueTypeMappings": { "10000": "scrum workflow" }, "name": "Example workflow scheme", "updateDraftIfNeeded": false }'

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

Responses

🟢200Returned if the request is successful.

application/json

Body

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have the necessary permission.

🟠404Returned if the workflow scheme is not found.

Update workflow scheme

Request

Responses