v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Issue types

Create issue type

Creates an issue type.

Permissions required: Administer Jira global permission.

post/rest/api/2/issuetype

Request body

descriptionstring

The description of the issue type.

hierarchyLevelinteger

The hierarchy level of the issue type. Use:

  • -1 for Subtask.
  • 0 for Base.

Defaults to 0.

namestring required

The unique name for the issue type. The maximum length is 60 characters.

type'subtask' | 'standard'

Deprecated. Use hierarchyLevel instead. See the deprecation notice for details.

Whether the issue type is subtype or standard. Defaults to standard.

Response

Returned if the request is successful.

avatarIdinteger

The ID of the issue type's avatar.

descriptionstring

The description of the issue type.

entityIdstring uuid

Unique ID for next-gen projects.

hierarchyLevelinteger

Hierarchy level of the issue type.

iconUrlstring

The URL of the issue type's avatar.

idstring

The ID of the issue type.

namestring

The name of the issue type.

selfstring

The URL of these issue type details.

subtaskboolean

Whether this issue type is used to create subtasks.