Jira

Jira Issue bulk operations API

This resource represents the issue bulk operations. Use it to move multiple issues from one project to another project or edit fields of multiple issues in one go. For additional clarity, we have created a page with further examples and answers to frequently asked questions related to these APIs. You can access it here: [Bulk operation APIs: additional examples and FAQ](https://developer.atlassian.com/cloud/jira/platform/bulk-operation-additional-examples-and-faqs/). ### Authentication ### Access to the issue bulk operations requires authentication. For information on how to authenticate API requests, refer to the [Basic auth for REST APIs documentation](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/). ### Rate limiting ### The bulk edit and move APIs are subject to the usual rate limiting infrastructure in Jira. For more information, refer to [Rate limiting](https://developer.atlassian.com/cloud/jira/platform/rate-limiting/). Additionally, at any given time, only 5 concurrent requests can be sent across all users.

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /rest/api/3/bulk/issues/delete Delete many issues in one request · Bulk delete issues #
Ask an LLM
“How do I delete hundreds of issues at once?”
“What's the maximum number of issues a single bulk delete can remove?”
Tell an agent destructive · confirm first
Bulk delete issues {selectedIssueIdsOrKeys}.
Delete issues {selectedIssueIdsOrKeys} with bulk notification set to {sendBulkNotification}.
GET /rest/api/3/bulk/issues/fields List fields that can be bulk edited on issues · Get bulk editable fields #
Ask an LLM
“Which fields can I bulk edit across a set of issues?”
“Can I search the bulk-editable fields by name?”
Tell an agent
List the fields I can bulk edit on issues {issueIdsOrKeys}.
Find bulk-editable fields matching {searchText} for issues {issueIdsOrKeys}.
POST /rest/api/3/bulk/issues/fields Edit fields on many issues at once · Bulk edit issues #
Ask an LLM
“Can I change the same field on a batch of issues in one go?”
“What limits apply to the number of issues and fields in a bulk edit?”
Tell an agent
Bulk edit issues {selectedIssueIdsOrKeys}, applying actions {selectedActions} with values {editedFieldsInput}.
Update fields {selectedActions} to {editedFieldsInput} on issues {selectedIssueIdsOrKeys}, sending bulk notification {sendBulkNotification}.
POST /rest/api/3/bulk/issues/move Move many issues to another project or type · Bulk move issues #
Ask an LLM
“How do I move issues from several projects into one target project?”
“Can a bulk move change the issue type and parent at the same time?”
Tell an agent
Bulk move issues using the target-to-source mapping {targetToSourcesMapping}.
Move issues per {targetToSourcesMapping} and set bulk notification to {sendBulkNotification}.
GET /rest/api/3/bulk/issues/transition List transitions available for bulk transitioning · Get available transitions #
Ask an LLM
“What status transitions can I apply to a group of issues together?”
“Which transition IDs are valid for a bulk transition of these issues?”
Tell an agent
List the bulk transitions available for issues {issueIdsOrKeys}.
Show the next page of available transitions for {issueIdsOrKeys} after {startingAfter}.
POST /rest/api/3/bulk/issues/transition Transition the status of many issues · Bulk transition issue statuses #
Ask an LLM
“Can I move up to 1,000 issues to a new status in one request?”
“How do I close out a batch of issues with their transition IDs?”
Tell an agent
Bulk transition issues using {bulkTransitionInputs}.
Apply transitions {bulkTransitionInputs} and send bulk notification {sendBulkNotification}.
POST /rest/api/3/bulk/issues/unwatch Stop watching many issues at once · Bulk unwatch issues #
Ask an LLM
“How do I unwatch a large batch of issues?”
“Is there a limit on how many issues I can unwatch in one request?”
Tell an agent
Unwatch issues {selectedIssueIdsOrKeys}.
Stop me watching all of {selectedIssueIdsOrKeys} in bulk.
POST /rest/api/3/bulk/issues/watch Start watching many issues at once · Bulk watch issues #
Ask an LLM
“Can I watch up to 1,000 issues with one request?”
“What permission do I need to bulk watch issues?”
Tell an agent
Watch issues {selectedIssueIdsOrKeys}.
Add me as a watcher on all of {selectedIssueIdsOrKeys} in bulk.
GET /rest/api/3/bulk/queue/{taskId} Check progress of a bulk issue operation · Get bulk issue operation progress #
Ask an LLM
“How far along is my bulk edit or bulk delete?”
“Did my bulk issue task finish, and which issues failed?”
Tell an agent
Check the progress of bulk task {taskId}.
Tell me whether bulk operation {taskId} has completed.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-bulk-operations-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-issue-bulk-operations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-issue-bulk-operations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Issue bulk operations API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-bulk-operations-api-openapi.yml