---
title: Transition a Jira issue
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-dotransition
---

Transitions a Jira issue to a different status. Use the [Get Jira issue transitions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-gettransitions) action to retrieve available transition IDs before calling this action.

For authentication setup, see [Jira issue actions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue).

## Inputs

| 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](https://id.atlassian.com/manage-profile/security/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](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-gettransitions) 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"}]`                                           |

## Outputs

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

## Example

| Workflow example                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ```yaml 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 ``` |