Set workflow for issue type in draft workflow scheme

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/workflowscheme//draft/issuetype/' \ --header 'Content-Type: application/json' \ --data-raw '{ "issueType": "10000", "updateDraftIfNeeded": false, "workflow": "jira" }'

{"id":17218781,"name":"Example workflow scheme","description":"The description of the example workflow scheme.","defaultWorkflow":"scrum workflow","issueTypeMappings":{"10000":"jira","10001":"jira"},"originalDefaultWorkflow":"jira","originalIssueTypeMappings":{"10001":"builds workflow"},"draft":true,"lastModifiedUser":{"self":"https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g","key":"","accountId":"5b10a2844c20165700ede21g","accountType":"atlassian","name":"","emailAddress":"mia@example.com","avatarUrls":{"48x48":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48","24x24":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24","16x16":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16","32x32":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32"},"displayName":"Mia Krystof","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]},"applicationRoles":{"size":1,"items":[]}},"lastModified":"Today 6:38 PM","self":"https://your-domain.atlassian.net/rest/api/3/workflowscheme/17218781/draft"}

Request

Path Params

integer

required

The ID of the workflow scheme that the draft belongs to.

issueType

string

required

The ID of the issue type.

Body Params application/json

Details about the mapping between an issue type and a workflow.

issueType

string

optional

The ID of the issue type. Not required if updating the issue type-workflow mapping.

updateDraftIfNeeded

boolean

optional

Set to true to create or update the draft of a workflow scheme and update the mapping in the draft, when the workflow scheme cannot be edited. Defaults to false. Only applicable when updating the workflow-issue types mapping.

workflow

string

optional

The name of the workflow.

Examples

Responses

🟢200Returned if the request is successful.

application/json

Body

Details about a workflow scheme.

defaultWorkflow

string

optional

The name of the default workflow for the workflow scheme. The default workflow has All Unassigned Issue Types assigned to it in Jira. If defaultWorkflow is not specified when creating a workflow scheme, it is set to Jira Workflow (jira).

description

string

optional

The description of the workflow scheme.

draft

boolean

read-onlyoptional

Whether the workflow scheme is a draft or not.

integer <int64>

read-onlyoptional

The ID of the workflow scheme.

issueTypeMappings

object

optional

The issue type to workflow mappings, where each mapping is an issue type ID and workflow name pair. Note that an issue type can only be mapped to one workflow in a workflow scheme.

Additional properties

string

optional

issueTypes

object

read-onlyoptional

The issue types available in Jira.

Additional properties

object (IssueTypeDetails)

optional

Details about an issue type.

lastModified

string

read-onlyoptional

The date-time that the draft workflow scheme was last modified. A modification is a change to the issue type-project mappings only. This property does not apply to non-draft workflows.

lastModifiedUser

object

read-onlyoptional

The user that last modified the draft workflow scheme. A modification is a change to the issue type-project mappings only. This property does not apply to non-draft workflows.

name

string

optional

The name of the workflow scheme. The name must be unique. The maximum length is 255 characters. Required when creating a workflow scheme.

originalDefaultWorkflow

string

read-onlyoptional

For draft workflow schemes, this property is the name of the default workflow for the original workflow scheme. The default workflow has All Unassigned Issue Types assigned to it in Jira.

originalIssueTypeMappings

object

read-onlyoptional

For draft workflow schemes, this property is the issue type to workflow mappings for the original workflow scheme, where each mapping is an issue type ID and workflow name pair. Note that an issue type can only be mapped to one workflow in a workflow scheme.

Additional properties

string

read-onlyoptional

self

string <uri>

read-onlyoptional

updateDraftIfNeeded

boolean

optional

Whether to create or update a draft workflow scheme when updating an active workflow scheme. An active workflow scheme is a workflow scheme that is used by at least one project. The following examples show how this property works:

Update an active workflow scheme with updateDraftIfNeeded set to true: If a draft workflow scheme exists, it is updated. Otherwise, a draft workflow scheme is created.

Update an active workflow scheme with updateDraftIfNeeded set to false: An error is returned, as active workflow schemes cannot be updated.

Update an inactive workflow scheme with updateDraftIfNeeded set to true: The workflow scheme is updated, as inactive workflow schemes do not require drafts to update.

Defaults to false.

🟠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 or issue type is not found.