---
title: "Restore an archived workspace, or retry a failed restore"
method: POST
path: "/support/workspaces/{workspace_id}/restore"
tags: ["Workspaces Support"]
---

# Restore an archived workspace, or retry a failed restore

`POST /support/workspaces/{workspace_id}/restore`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/support/workspaces/{workspace_id}/restore`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Queue the job that brings the workspace data back from S3. The workspace stays ARCHIVED until the job finishes. Admin only.

## Path parameters

- `workspace_id` integer, required: Id of the workspace to work with

## Response `202`

Archive or restore run queued

- ArchiveRun
  - `ledger` LedgerView, required
    - `archive_id` string, nullable
    - `state` string, nullable
    - `op` string, nullable
    - `step` string, nullable
    - `storage_class` string, nullable
    - `by` integer, nullable
    - `reason` string, nullable
    - `started_at` string, nullable
    - `heartbeat` string, nullable
    - `completed_at` string, nullable
    - `error` string, nullable
    - `files` integer, nullable
    - `bytes_physical` integer, nullable
    - `bytes_orphan` integer, nullable
    - `bytes_done` integer, nullable
    - `thaw_requested_at` string, nullable
    - `s3_delete_after` string, nullable
    - `s3_deleted` boolean, nullable
    - `prior_status` string, nullable
    - `chunks_done` integer
    - `chunks_total` integer
    - `stalled` boolean
    - `restorable` boolean

## Other responses

- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)