Create issue type screen scheme

Creates an issue type screen scheme.

Permissions required: Administer Jira global permission.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issuetypescreenscheme' \ --header 'Content-Type: application/json' \ --data-raw '{ "issueTypeMappings": [ { "issueTypeId": "default", "screenSchemeId": "10001" }, { "issueTypeId": "10001", "screenSchemeId": "10002" }, { "issueTypeId": "10002", "screenSchemeId": "10002" } ], "name": "Scrum issue type screen scheme" }'

Request

Body Params application/json

The details of an issue type screen scheme.

description

string

write-onlyoptional

The description of the issue type screen scheme. The maximum length is 255 characters.

issueTypeMappings

array[object (IssueTypeScreenSchemeMapping) {2}]

write-onlyrequired

The IDs of the screen schemes for the issue type IDs and default. A default entry is required to create an issue type screen scheme, it defines the mapping for all issue types without a screen scheme.

issueTypeId

string

write-onlyrequired

The ID of the issue type or default. Only issue types used in classic projects are accepted. An entry for default must be provided and defines the mapping for all issue types without a screen scheme.

screenSchemeId

string

write-onlyrequired

The ID of the screen scheme. Only screen schemes used in classic projects are accepted.

name

string

write-onlyrequired

The name of the issue type screen scheme. The name must be unique. The maximum length is 255 characters.

Examples

Responses

🟢201Returned if the request is successful.

application/json

Body

The ID of an issue type screen scheme.

string

read-onlyrequired

The ID of the issue type screen scheme.

🟠400Returned if the request is not valid.

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

🟠403Returned if the user does not have the required permissions.

🟠404Returned if the issue type or screen scheme is not found.

🟠409Returned if the issue type is a sub-task, but sub-tasks are disabled in Jira settings.