JIRA 7.6.1

Get project issue type hierarchy

Deprecated

GET

/rest/api/3/project/{projectId}/hierarchy

Projects

Get the issue type hierarchy for a next-gen project.

The issue type hierarchy for a project consists of:

Epic at level 1 (optional).

One or more issue types at level 0 such as Story, Task, or Bug. Where the issue type Epic is defined, these issue types are used to break down the content of an epic.

Subtask at level -1 (optional). This issue type enables level 0 issue types to be broken down into components. Issues based on a level -1 issue type must have a parent issue.

Permissions required: Browse projects project permission for the project.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://jira.local:8080/jira/rest//rest/api/3/project//hierarchy'

Response Example

200 - Success

{
  "projectId": 10030,
  "hierarchy": [
    {
      "entityId": "00c6196c-2f5a-4d15-8439-3211098871e7",
      "level": 0,
      "name": "Base",
      "issueTypes": [
        {
          "id": 10008,
          "entityId": "f0b555ab-a707-49cf-831f-823dad323581",
          "name": "Story",
          "avatarId": 10324
        },
        {
          "id": 10001,
          "entityId": "3ba33091-32e0-47e8-a558-be98bb4996f0",
          "name": "Bug",
          "avatarId": 10324
        }
      ]
    },
    {
      "entityId": "6b7b4500-8e34-4746-97b7-722879aa60ae",
      "level": 1,
      "name": "Epic",
      "issueTypes": [
        {
          "id": 10007,
          "entityId": "df832484-823b-4856-94bc-d5f9807b7bea",
          "name": "Epic",
          "avatarId": 10179
        }
      ]
    },
    {
      "entityId": "b1079ae2-9a9c-4003-a9ea-33376160d837",
      "level": -1,
      "name": "Subtask",
      "issueTypes": [
        {
          "id": 10009,
          "entityId": "9fca0880-c3bd-4034-9356-531c23ad666e",
          "name": "Subtask",
          "avatarId": 10573
        }
      ]
    }
  ]
}

Request

Path Params

projectId

integer

required

The ID of the project.

Responses

🟢200Returned if the request is successful.

application/json

Body

The hierarchy of issue types within a project.

hierarchy

array[object (ProjectIssueTypesHierarchyLevel) {4}]

read-onlyoptional

Details of an issue type hierarchy level.

entityId

string <uuid>

read-onlyoptional

The ID of the issue type hierarchy level. This property is deprecated, see Change notice: Removing hierarchy level IDs from next-gen APIs.

issueTypes

array[object (IssueTypeInfo) {3}]

read-onlyoptional

The list of issue types in the hierarchy level.

level

integer <int32>

read-onlyoptional

The level of the issue type hierarchy level.

name

string

read-onlyoptional

The name of the issue type hierarchy level.

projectId

integer <int64>

read-onlyoptional

The ID of the project.

🟠400Returned if the request is invalid.

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

🟠404Returned if the project is not found or the user does not have the necessary permission.

Modified at 2023-07-13 03:27:27

Get all statuses for project

Get project notification scheme