Get available transitions

v1.0.0

Use this API to retrieve a list of transitions available for the specified issues that can be used or bulk transition operations. You can submit either single or multiple issues in the query to obtain the available transitions.

The response will provide the available transitions for issues, organized by their respective workflows. Only the transitions that are common among the issues within that workflow and do not involve any additional field updates will be included. For bulk transitions that require additional field updates, please utilise the Jira Cloud UI.

You can request available transitions for up to 1,000 issues in a single operation. This API uses pagination to return responses, delivering 50 workflows at a time.

required:

Global bulk change .
Transition in all projects that contain the selected issues.
Browse in all projects that contain the selected issues.
If is configured, issue-level security permission to view the issue.

Input

{
  "type": "object",
  "properties": {
    "endingBefore": {
      "type": "string"
    },
    "issueIdsOrKeys": {
      "type": "string"
    },
    "startingAfter": {
      "type": "string"
    }
  },
  "required": [
    "issueIdsOrKeys"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Bulk Transition Get Available Transitions Response.",
  "properties": {
    "availableTransitions": {
      "type": "array",
      "description": "List of available transitions for bulk transition operation for requested issues grouped by workflow",
      "items": {
        "type": "object",
        "properties": {
          "isTransitionsFiltered": {
            "type": "boolean",
            "description": "Indicates whether all the transitions of this workflow are available in the transitions list or not."
          },
          "issues": {
            "type": "array",
            "description": "List of issue keys from the request which are associated with this workflow.",
            "items": {
              "type": "string"
            }
          },
          "transitions": {
            "type": "array",
            "description": "List of transitions available for issues from the request which are associated with this workflow.\n\n **This list includes only those transitions that are common across the issues in this workflow and do not involve any additional field updates.** ",
            "items": {
              "type": "object",
              "properties": {
                "to": {
                  "description": "The issue status change of the transition.",
                  "type": "object"
                },
                "transitionId": {
                  "type": "integer",
                  "format": "int32",
                  "description": "The unique ID of the transition."
                },
                "transitionName": {
                  "type": "string",
                  "description": "The name of the transition."
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      }
    },
    "endingBefore": {
      "type": "string",
      "description": "The end cursor for use in pagination."
    },
    "startingAfter": {
      "type": "string",
      "description": "The start cursor for use in pagination."
    }
  },
  "additionalProperties": false
}