Get Jira issue transitions | New Relic Documentation

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	Type	Description	Example
authToken	String	Required. 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	String	Required. Your Jira Cloud instance domain (company name). Used to construct the base URL `your-domain.atlassian.net`.	`"mycompany"`
issueKey	String	Required. The key of the Jira issue to get transitions for.	`"PROJ-1234"`
parameters	Map	Optional. Optional URL query parameters for the Jira API request. See the parameters reference table below.	`{"fields": "summary,status", "expand": "transitions"}`
selectors	List	Optional. 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	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