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

# Create snapshot

`POST /sandboxes/{sandboxID}/snapshots`

Create a persistent snapshot from the sandbox's current state. Snapshots can be used to create new sandboxes and persist beyond the original sandbox's lifetime.

## Path parameters

- `sandboxID` string, required

## Request body

- SandboxSnapshotRequest
  - `name` string — Optional name for the snapshot template. If a snapshot template with this name already exists, a new build will be assigned to the existing template instead of creating a new one.

## Response `201`

Snapshot created successfully

- SnapshotInfo
  - `snapshotID` string, required — Identifier of the snapshot template including the tag. Uses namespace/alias when a name was provided (e.g. team-slug/my-snapshot:default), otherwise falls back to the raw template ID (e.g. abc123:default).
  - `names` string[], required — Full names of the snapshot template including team namespace and tag (e.g. team-slug/my-snapshot:v2)

## Other responses

- `400` — Bad request
- `401` — Authentication error
- `404` — Not found
- `500` — Server error

## Changes

> 53 revisions in range; 4 could not be searched.

- **2026-07-24** `93ed246a4c10` — 2 info
  - the endpoint scheme security `AdminApiKeyAuth AND AdminTeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was removed from the API
- **2026-05-27** `e13ef89d456c` — 1 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
- **2026-02-24** `0bcb69c4169b` — 1 info
  - endpoint added
- **2023-11-15** `897ba2f1c7b6` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/sandboxes/:sandboxID/snapshots/post.md)

---

[API](https://skmtc.dev/e2b-dev/apis/e2b-api.md) · [All operations](https://skmtc.dev/e2b-dev/apis/e2b-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/e2b-dev/e2b-api/revisions/e01b3f5506fe/schema)