Hello Jira Admins and Developers!
We’re excited to unveil a game-changing feature in the Jira REST API (v3)—the Bulk Transition API! This long-awaited addition empowers you to transition multiple issues in one go, making it easier than ever to streamline workflows and automate repetitive tasks.
Let’s explore how this powerful API works and how it can save you time.
Why the Bulk Transition API?
Transitions are an integral part of moving issues through workflows in Jira. However, transitioning each issue manually, especially in bulk operations, can be time-consuming and error-prone. The Bulk Transition API eliminates this bottleneck by allowing you to:
- Transition up to 1000 issues in a single API call.
- Simplify bulk workflow updates.
- Enhance automation for faster, more efficient processes.
This means more focus on value-adding activities and less time spent on tedious manual work.
The Bulk Transition API: Two Key Endpoints
1. Get Available Transitions for Bulk Issues
GET /rest/api/3/bulk/issues/transition
This endpoint helps you identify which transitions are available for a specific set of issues. Simply provide the issue IDs or keys, and the API will return the valid transitions across the selected issues.
👉 View full documentation
Example Use Case:
If you’re managing a large batch of issues and need to determine which transitions are shared across them, this endpoint ensures that you’re working with accurate workflow options.
What You’ll Send:
- A list of issue IDs or keys in the request.
What You’ll Receive:
- A response detailing the available transitions for each issue.
2. Bulk Transition Issues
POST /rest/api/3/bulk/issues/transition
This is where you can make transitions happen in bulk. By providing a list of issue IDs or keys, along with the transition ID, you can move multiple issues to a new status in one go.
👉 View full documentation
Example Use Case:
Imagine closing a sprint and needing to move 1000 completed issues to "Done." With this endpoint, a single API call handles the entire process seamlessly.
What You’ll Send:
- A list of issue IDs or keys.
- The transition ID for the desired status.
What You’ll Receive:
- The success response returns a task id of the bulk transition operation and the task progress can be monitored using the bulk operation progress API.
Key Considerations
- Limits: The API supports transitioning up to 1000 issues per request. For larger batches, you can split them into multiple requests.
- Permissions: The API respects Jira’s permissions model, so ensure the requesting user has the required permissions for the targeted issues.
- Error Handling: The API provides detailed feedback on failed transitions to help you identify and resolve any issues.
Get Started Today!
Ready to transform how you manage workflows? The Bulk Transition API is live and ready to use. Check out the detailed developer documentation for everything you need to get started:
Your Feedback Matters! ❤️
We’d love to hear how the Bulk Transition API is making a difference in your workflows. Have ideas for improvements or unique use cases? Share your thoughts in the comments below or join the conversation in the Atlassian Community.
We’re excited to see how you unlock the power of bulk operations to supercharge your Jira workflows. Happy transitioning! 🎉
Cheers,
Yousef Abusamak
Sr. Product Manager
