---
title: "Restore a file"
method: PUT
path: "/v1/files/{file-id}/restore"
tags: ["Files"]
---

# Restore a file

`PUT /v1/files/{file-id}/restore`

Restores a previously archived file to its RESTORED status. Once a file is archived, it cannot be used directly until the file is restored using this API.
### Notes
- This API operation will fail if the count of restored files exceeds the quota limit (1000 by default) in the past 24 hours.
- The actual restoration process may take between 12 to 48 hours to complete.
- You can monitor the status of the file restoration process using the [Retrieve file status](https://developer.zuora.com/api-references/api/operation/GET_FileStatus) API operation until the status transitions to `RESTORED`.

## Path parameters

- `file-id` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- RestoreFile
  - `success` boolean — Returns `true` if the request was processed successfully. Returns `false` if the quota limit is exceeded, and you will see an error message in the response body. For example, "Your file restoration request can not be processed currently due to reaching the maximum daily limit of 1000 files as of 2024-04-01 14:12. Please wait for the limit to be refreshed or reach out to Zuora support if the request is urgent." In such cases, wait for a limit refresh or submit a request at [Zuora Global Support](https://support.zuora.com/).
  - `fileId` string — The unique ID of the file.
  - `status` 'ACTIVE' | 'ARCHIVING' | 'ARCHIVED' | 'RESTORE_ACCEPTED' | 'RESTORE_IN_PROGRESS' | 'RESTORED' — The status of the file restore operation.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)