Get transitions - JIRA 7.6.1

Returns either all transitions or a transition that can be performed by the user on an issue, based on the issue's status.

Note, if a request is made for a transition that does not exist or cannot be performed on the issue, given its status, the response will return any empty transitions list.

This operation can be accessed anonymously.

Permissions required: A list or transition is returned only when the user has:

Browse projects project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

However, if the user does not have the Transition issues project permission the response will not list any transitions.

{ "transitions": [ { "id": "2", "name": "Close Issue", "to": { "self": "https://your-domain.atlassian.net/rest/api/3/status/10000", "description": "The issue is currently being worked on.", "iconUrl": "https://your-domain.atlassian.net/images/icons/progress.gif", "name": "In Progress", "id": "10000", "statusCategory": { "self": "https://your-domain.atlassian.net/rest/api/3/statuscategory/1", "id": 1, "key": "in-flight", "colorName": "yellow", "name": "In Progress" } }, "hasScreen": false, "isGlobal": false, "isInitial": false, "isAvailable": true, "isConditional": false, "fields": { "summary": { "required": false, "schema": { "type": "array", "items": "option", "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect", "customId": 10001 }, "name": "My Multi Select", "key": "field_key", "hasDefaultValue": false, "operations": [ "set", "add" ], "allowedValues": [ "red", "blue" ], "defaultValue": "red" } } }, { "id": "711", "name": "QA Review", "to": { "self": "https://your-domain.atlassian.net/rest/api/3/status/5", "description": "The issue is closed.", "iconUrl": "https://your-domain.atlassian.net/images/icons/closed.gif", "name": "Closed", "id": "5", "statusCategory": { "self": "https://your-domain.atlassian.net/rest/api/3/statuscategory/9", "id": 9, "key": "completed", "colorName": "green" } }, "hasScreen": true, "fields": { "summary": { "required": false, "schema": { "type": "array", "items": "option", "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect", "customId": 10001 }, "name": "My Multi Select", "key": "field_key", "hasDefaultValue": false, "operations": [ "set", "add" ], "allowedValues": [ "red", "blue" ], "defaultValue": "red" }, "colour": { "required": false, "schema": { "type": "array", "items": "option", "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect", "customId": 10001 }, "name": "My Multi Select", "key": "field_key", "hasDefaultValue": false, "operations": [ "set", "add" ], "allowedValues": [ "red", "blue" ], "defaultValue": "red" } } } ] }

Request

Path Params

issueIdOrKey

string

required

The ID or key of the issue.

Query Params

expand

string

optional

Use expand to include additional information about transitions in the response. This parameter accepts transitions.fields, which returns information about the fields in the transition screen for each transition. Fields hidden from the screen are not returned. Use this information to populate the fields and update fields in Transition issue.

transitionId

string

optional

The ID of the transition.

skipRemoteOnlyCondition

string

optional

Whether transitions with the condition Hide From User Condition are included in the response.

includeUnavailableTransitions

string

optional

Whether details of transitions that fail a condition are included in the response

sortByOpsBarAndStatus

string

optional

Whether the transitions are sorted by ops-bar sequence value first then category order (Todo, In Progress, Done) or only by ops-bar sequence value.

Responses

🟢200Returned if the request is successful.

application/json

Body

List of issue transitions.

expand

string

read-onlyoptional

Expand options that include additional transitions details in the response.

transitions

array[object (IssueTransition) {12}]

read-onlyoptional

List of issue transitions.

expand

string

read-onlyoptional

Expand options that include additional transition details in the response.

fields

object

read-onlyoptional

Details of the fields associated with the issue transition screen. Use this information to populate fields and update in a transition request.

hasScreen

boolean

read-onlyoptional

Whether there is a screen associated with the issue transition.

string

optional

The ID of the issue transition. Required when specifying a transition to undertake.

isAvailable

boolean

read-onlyoptional

Whether the transition is available to be performed.

isConditional

boolean

read-onlyoptional

Whether the issue has to meet criteria before the issue transition is applied.

isGlobal

boolean

read-onlyoptional

Whether the issue transition is global, that is, the transition is applied to issues regardless of their status.

isInitial

boolean

read-onlyoptional

Whether this is the initial issue transition for the workflow.

looped

boolean

optional

name

string

read-onlyoptional

The name of the issue transition.

object

read-onlyoptional

Details of the issue status after the transition.

Additional properties

integer | number | string | boolean

optional

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

🟠404Returned if the issue is not found or the user does not have permission to view it.