Transition a Jira issue | New Relic Documentation

Transitions a Jira issue to a different status. Use the Get Jira issue transitions action to retrieve available transition IDs before calling this action.

For authentication setup, see Jira issue actions.

Input	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 transition.	`"PROJ-123"`
transitionId	Required. String	The ID of the target transition. Use the Get Jira issue transitions action to retrieve available transition IDs for an issue.	`"181"`
fields	Optional. Map	A map of issue screen fields to update during the transition. Fields included here cannot also be included in `update`. To get all fields with allowed values, use `GET /rest/api/3/issue/{issueKey}/editmeta`.	`{"priority": {"name": "High"}, "labels": ["bug", "production"]}`
update	Optional. Map	A map of field names and a list of operations to perform during the transition. Fields included here cannot also be included in `fields`.	`{"labels": [{"add": "critical"}, {"remove": "minor"}], "components": [{"set": [{"name": "Backend"}]}]}`
selectors	Optional. List	A list of named expressions to extract specific values from the response.	`[{"name": "statusCode", "expression": ".result.statusCode"}]`

Output	Type	Example
response	Object	A successful transition returns an empty body with status 204.
success	Boolean	`success: true \| false`
errorMessage	String	`{ "errorMessages": ["Can not update issue with invalid data"], "errors": { "summary": "Summary is required" } }`

Workflow example
`name: transition-jira-issue description: 'Transition a Jira issue status and update fields during the transition' steps: - name: transitionJiraIssue type: action action: jira.issue.doTransition version: 1 inputs: authToken: ${{ :secrets:jiraAuthToken }} domain: mycompany issueKey: "PROJ-123" transitionId: "181" fields: customfield_14691: id: "17907" next: end`

Workflow example

name: transition-jira-issue
description: 'Transition a Jira issue status and update fields during the transition'
steps:
  - name: transitionJiraIssue
    type: action
    action: jira.issue.doTransition
    version: 1
    inputs:
      authToken: ${{ :secrets:jiraAuthToken }}
      domain: mycompany
      issueKey: "PROJ-123"
      transitionId: "181"
      fields:
        customfield_14691:
          id: "17907"
    next: end