---
title: "Archive issue(s) by JQL"
method: POST
path: "/rest/api/3/issue/archive"
tags: ["Issues"]
---

# 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](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-get) and [cancel task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-cancel-post) 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](#permissions) required:** Jira admin or site admin: [global permission](https://confluence.atlassian.com/x/x4dKLg)

**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 body

- ArchiveIssueAsyncRequest
  - `jql` string

## Response `202`

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

- string

## Other responses

- `400` — Returned if no issues were archived due to a bad request, for example an invalid JQL query.
- `401` — Returned if no issues were archived because the provided authentication credentials are either missing or invalid.
- `403` — Returned if no issues were archived because the user lacks the required Jira admin or site admin permissions.
- `412` — Returned if a request to archive issue(s) is already running.

---

[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/ec7f275dfee5/schema)