---
title: "POST /v1/snapshots/{id}/restore"
method: POST
path: "/v1/snapshots/{id}/restore"
---

# POST /v1/snapshots/{id}/restore

`POST /v1/snapshots/{id}/restore`

## Path parameters

- `id` string, required — Snapshot ID or name

## Request body

- RestoreSnapshotRequest
  - `name` string, required — Name for the restored sandbox
  - `resources` object — Resource overrides for restored sandbox
    - `cpus` integer — Number of CPUs (minimum: 1, 1 CPU = 0.25 Kubernetes vCPU)
    - `memory` integer — Memory size in MiB
    - `storage` string — Storage size (must be >= snapshot size)
  - `image` string — Docker image override
  - `wait_for_ready` boolean — Wait for sandbox to be ready

## Response `201`

Sandbox restored from snapshot

- RestoredSandbox
  - `id` string, required — Sandbox ID
  - `name` string, required — Sandbox name
  - `created_at` string, required — Creation timestamp
  - `cpu` number, required — CPU count (API units, minimum 1)
  - `memory` number, required — Memory size in MB
  - `status` string, required — Sandbox status
  - `storage_id` string — ID of the attached storage volume
  - `storage_name` string — Name of the attached storage volume

## Other responses

- `400` — Bad request (e.g., snapshot not ready)
- `401` — Authentication required
- `403` — Forbidden (snapshot does not belong to user)
- `404` — Snapshot not found
- `500` — Internal server error

## Changes

- **2026-01-26** `260daed67193` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/snapshots/:id/restore/post.md)

---

[API](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api.md) · [All operations](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avm-codes/avm-sandbox-platform-api/revisions/260daed67193/schema)