Get Jira issue transitions

Gets the available statuses to which a Jira issue can transition. Use this action to retrieve transition IDs before calling the Transition a Jira issue action.

For authentication setup, see Jira issue actions.

Input Field	Optionality	Type	Description	Example
authToken	Required	String	Base64-encoded string of `email:API_Token` for Basic Authentication. Must be provided as a secret. See Create and manage API tokens.	`"${{ :secrets:jiraAuthToken }}"`
domain	Required	String	Your Jira Cloud instance domain (company name). Used to construct the base URL `your-domain.atlassian.net`.	`"mycompany"`
issueKey	Required	String	The key of the Jira issue to get transitions for.	`"PROJ-1234"`
parameters	Optional	Map	Optional URL query parameters for the Jira API request. See the parameters reference table below.	`{"fields": "summary,status", "expand": "transitions"}`
selectors	Optional	List	A list of named expressions to extract specific values from the response.	`[{"name": "summary", "expression": ".responseBody.result.summary"}]`

Parameters reference

Parameter	Type	Description	Default
expand	String	Use `transitions.fields` to return information about the fields in the transition screen for each transition. Fields hidden from the screen are not returned. Use this to populate the `fields` and `update` inputs in the Transition a Jira issue action.
transitionId	String	Filter results to a specific transition by its ID.
skipRemoteOnlyCondition	Boolean	Whether to include transitions with the condition Hide From User Condition in the response. Available to Connect and Forge app users with Administer Jira global permission.	`false`
includeUnavailableTransitions	Boolean	Whether to include details of transitions that fail a condition in the response.	`false`
sortByOpsBarAndStatus	Boolean	When `true`, transitions are sorted by ops-bar sequence value first, then by category order (Todo, In Progress, Done). When `false`, sorted only by ops-bar sequence value.	`false`

Output Field	Type	Example
response	Object	`{ "id": "151", "name": "Selected for Development", ... }`
success	Boolean	`success: true \| false`
errorMessage	String	`{ "errorMessages": ["Issue does not exist or you do not have permission to see it."], "errors": {} }`

Workflow example
`name: get-jira-issue-transitions description: 'Get available transitions for a Jira issue.' steps: - name: get_transitions type: action action: jira.issue.getTransitions version: 1 inputs: authToken: ${{ :secrets:jiraAuthToken }} domain: mycompany issueKey: PROJ-567 parameters: sortByOpsBarAndStatus: true next: end`

Workflow example

name: get-jira-issue-transitions
description: 'Get available transitions for a Jira issue.'
steps:
  - name: get_transitions
    type: action
    action: jira.issue.getTransitions
    version: 1
    inputs:
      authToken: ${{ :secrets:jiraAuthToken }}
      domain: mycompany
      issueKey: PROJ-567
      parameters:
        sortByOpsBarAndStatus: true
    next: end