---
title: "List sandbox snapshots"
method: GET
path: "/sandboxes/{sandboxName}/snapshots"
tags: ["compute"]
---

# List sandbox snapshots

`GET /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:list`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blaxel/apis/blaxel-control-plane/docs/sandboxes/:sandboxName/snapshots/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of snapshots for the specified sandbox.

## Path parameters

- `sandboxName` string, required

## Response `200`

successful operation

- SandboxSnapshot[]
  - `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

---

[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)