---
title: "POST /v1/sandboxes/{id}/snapshot"
method: POST
path: "/v1/sandboxes/{id}/snapshot"
---

# POST /v1/sandboxes/{id}/snapshot

`POST /v1/sandboxes/{id}/snapshot`

## Path parameters

- `id` string, required — Sandbox ID

## Request body

- CreateSnapshotRequest
  - `name` string — Custom snapshot name (auto-generated if not provided)
  - `quick` boolean — Quick mode: fsfreeze only (faster but crash-consistent)

## Response `201`

Snapshot created

- Snapshot
  - `id` string, required — Snapshot ID (Kubernetes UID)
  - `name` string, required — Snapshot name
  - `source_sandbox_id` string, required — Source sandbox ID
  - `source_sandbox_name` string, required — Source sandbox name
  - `status` 'creating' | 'ready' | 'error', required — Snapshot status
  - `created_at` string, required — Creation timestamp
  - `consistency` 'application' | 'crash', required — Snapshot consistency level

## Other responses

- `400` — Bad request - sandbox not running or has no storage
- `403` — Forbidden - Sandbox does not belong to user
- `404` — Sandbox not found
- `409` — Conflict - Snapshot name already exists
- `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/sandboxes/:id/snapshot/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)