Archive issue(s) by JQL

POST

/rest/api/3/issue/archive

Enables admins to archive up to 100,000 issues in a single request using JQL, returning the URL to check the status of the submitted request.

You can use the get task and cancel task APIs to manage the request.

Note that:

you can't archive subtasks directly, only through their parent issues

you can only archive issues from software, service management, and business projects

Permissions required: Jira admin or site admin: global permission

License required: Premium or Enterprise

Signed-in users only: This API can't be accessed anonymously.

Rate limiting: Only a single request per jira instance can be active at any given time.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/issue/archive' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jql": "project = FOO AND updated < -2y"
}'

Response Example

202 - Success

"https://your-domain.atlassian.net/rest/api/3/task/1010"

Request

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Returns the URL to check the status of the submitted request.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠412412

Modified at 2025-07-16 07:18:01

Create issue

Archive issue(s) by issue ID/key