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

# Create sandbox snapshot

`POST /sandboxes/{sandboxName}/snapshots`

## Request

- Base URL: `https://api.blaxel.ai/v0`
- URL: `https://api.blaxel.ai/v0/sandboxes/{sandboxName}/snapshots`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Client credentials
    - Token URL: `/oauth/token` scopes: `sandboxes:update`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blaxel/apis/blaxel-control-plane/docs/sandboxes/:sandboxName/snapshots/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/blaxel/apis/blaxel-control-plane.md) - [All operations](https://skmtc.dev/blaxel/apis/blaxel-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/blaxel/apis/blaxel-control-plane/revisions/dfa264bc72ee?raw)