---
title: "Bulk transition issue statuses"
method: POST
path: "/rest/api/3/bulk/issues/transition"
tags: ["Issue bulk operations"]
---

# Bulk transition issue statuses

`POST /rest/api/3/bulk/issues/transition`

Use this API to submit a bulk issue status transition request. You can transition multiple issues, alongside with their valid transition Ids. You can transition up to 1,000 issues in a single operation.

**[Permissions](#permissions) required:**

 *  Global bulk change [permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
 *  Transition [issues permission](https://support.atlassian.com/jira-cloud-administration/docs/permissions-for-company-managed-projects/#Transition-issues/) in all projects that contain the selected issues.
 *  Browse [project permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/) in all projects that contain the selected issues.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Request body

- IssueBulkTransitionPayload — Issue Bulk Transition Payload
  - `bulkTransitionInputs` BulkTransitionSubmitInput[], required — List of objects and each object has two properties: * Issues that will be bulk transitioned. * TransitionId that corresponds to a specific transition of issues that share the same workflow.
    - `selectedIssueIdsOrKeys` string[], required — List of all the issue IDs or keys that are to be bulk transitioned.
    - `transitionId` string, required — The ID of the transition that is to be performed on the issues.
  - `sendBulkNotification` boolean, nullable — A boolean value that indicates whether to send a bulk change notification when the issues are being transitioned. If `true`, dispatches a bulk notification email to users about the updates.

## Response `201`

Returned if the request is successful.

- SubmittedBulkOperation
  - `taskId` string

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)