Create issue type scheme

Creates an issue type scheme.

Permissions required: Administer Jira global permission.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issuetypescheme' \ --header 'Content-Type: application/json' \ --data-raw '{ "defaultIssueTypeId": "10002", "description": "A collection of issue types suited to use in a kanban style project.", "issueTypeIds": [ "10001", "10002", "10003" ], "name": "Kanban Issue Type Scheme" }'

Request

Body Params application/json

Details of an issue type scheme and its associated issue types.

defaultIssueTypeId

string

write-onlyoptional

The ID of the default issue type of the issue type scheme. This ID must be included in issueTypeIds.

description

string

write-onlyoptional

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

issueTypeIds

array[string]

write-onlyrequired

The list of issue types IDs of the issue type scheme. At least one standard issue type ID is required.

name

string

write-onlyrequired

The name of the issue type 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 scheme.

issueTypeSchemeId

string

read-onlyrequired

The ID of the issue type 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.

🟠409Returned if the scheme name is used by another scheme.