---
title: "Archive pages"
method: POST
path: "/wiki/rest/api/content/archive"
tags: ["Content"]
---

# Archive pages

`POST /wiki/rest/api/content/archive`

Archives a list of pages. The pages to be archived are specified as a list of content IDs.
This API accepts the archival request and returns a task ID.
The archival process happens asynchronously.
Use the /longtask/<taskId> REST API to get the copy task status.

Each content ID needs to resolve to page objects that are not already in an archived state.
The content IDs need not belong to the same space.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'Archive' permission for each of the pages in the corresponding space it belongs to.

## Request body

- object
  - `pages` object[]
    - `id` integer, required — The `id` of the page to be archived.

## Response `202`

Returned if the archive request has been submitted.

- LongTask
  - `ari` string — the ARI for the long task, based on its ID
  - `id` string, required — a unique identifier for the long task
  - `links` object, required
    - `status` string — The URL to retrive status of long task.

## Other responses

- `400` — Returned if: - there is an archival job already running for the tenant. - the number of pages to archive is larger than the limit of 300. - any of the content IDs specified in the array do not resolve to pages. - any of the specified pages are already archived. - the request is coming from a free edition tenant. - the request is coming from a non premium edition tenant with more than 1 page ID in the archive request.
- `401` — Returned if the authentication credentials are incorrect or missing from the request.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)