GET /rest/api/2/issue/{issueIdOrKey}/transitions
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.
Servers
- https://your-domain.atlassian.net
Path parameters
Name | Type | Required | Description |
---|---|---|---|
issueIdOrKey |
String | Yes |
The ID or key of the issue. |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
transitionId |
String | No |
The ID of the transition. |
includeUnavailableTransitions |
Boolean | No |
Whether details of transitions that fail a condition are included in the response Default value: false |
skipRemoteOnlyCondition |
Boolean | No |
Whether transitions with the condition Hide From User Condition are included in the response. Default value: false |
expand |
String | No |
Use expand to include additional information about transitions in the response. This parameter accepts |
sortByOpsBarAndStatus |
Boolean | No |
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. Default value: false |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.