---
title: "Restore Object from archival storage."
method: POST
path: "/{bucketName}/{object}"
tags: ["Backup"]
---

# Restore Object from archival storage.

`POST /{bucketName}/{object}`

## Request body

- RestoreObject — Restore object request
  - `tier` string — the retrieval option when restoring an archived object. This is cloud vendor specific.
  - `days` integer — The Days element is required for regular restore. Required for restoring archived object.

## Response `200`

Successful restoration of Object initiated

## Other responses

- `403` — Forbidden; Access Denied, InvalidAccessKey, SignatureDoesNotMatch, RestoreFailed
- `404` — Not Found i.e. No Such Bucket
- `409` — Restoration of object is already in porgress

## Changes

- **2026-07-17** `c02dd33a522b` — 3 info
  - endpoint added
  - added the new optional `header` request parameter `X-AMZ-Storage-Class` to all path's operations
  - added the new optional `query` request parameter `restore` to all path's operations
- **2023-09-17** `d4f502a59e17` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/sodafoundation/apis/soda-crystal-api/changes/:bucketName/:object/post.md)

---

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