---
title: "Create sandbox snapshot"
method: POST
path: "/sandboxes/{sandboxName}/snapshots"
tags: ["compute"]
---

# Create sandbox snapshot

`POST /sandboxes/{sandboxName}/snapshots`

Creates a point-in-time snapshot of a sandbox. Snapshots capture the sandbox state and can be used for forking into new sandboxes or applications. This is a WIP endpoint — the full implementation depends on the execution plane.

## Path parameters

- `sandboxName` string, required

## Request body

- SandboxSnapshotRequest — Request body for creating a snapshot of a sandbox. Captures the current sandbox state.
  - `name` string — Optional human-readable name for the snapshot

## Response `200`

Snapshot created successfully

- SandboxSnapshot — A point-in-time snapshot of a sandbox that can be used for forking into a new sandbox or application.
  - `createdAt` string, required — When the snapshot was created
  - `createdBy` string — Who created the snapshot
  - `id` string, required — Unique snapshot identifier
  - `name` string — Optional human-readable name for the snapshot
  - `sandboxName` string, required — Name of the source sandbox
  - `status` string, required — Status of the snapshot (pending, ready, failed)
  - `workspace` string, required — Workspace of the source sandbox

## Other responses

- `404` — Not found - Sandbox does not exist
- `500` — Internal server error

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/versions/dfa264bc72ee/schema)