---
title: "Create a new snapshot of a sandbox"
method: POST
path: "/workspaces/{workspace_domain}/sandboxes/{sandbox_id}/snapshots"
tags: ["Sandbox API"]
---

# Create a new snapshot of a sandbox

`POST /workspaces/{workspace_domain}/sandboxes/{sandbox_id}/snapshots`

## Path parameters

- `workspace_domain` string, required
- `sandbox_id` string, required

## Request body

- AddSnapshotRequest
  - `name` string — Snapshot name

## Response `201`

- SnapshotView
  - `url` string — API endpoint to GET this object
  - `html_url` string — Web URL to view this object in Buddy.works
  - `id` string — The ID of the snapshot
  - `name` string — Snapshot name
  - `size` integer — Snapshot size in GB
  - `status` 'CREATING' | 'CREATED' | 'DELETING' | 'FAILED' — Snapshot status
  - `create_date` string, date-time — Snapshot creation date
  - `created_by` MemberView — User/member reference
    - `url` string — API endpoint to GET this object
    - `html_url` string — Web URL to view this object in Buddy.works
    - `id` integer — The ID of the user
    - `name` string — The name of the user
    - `avatar_url` string — The avatar URL of the user
    - `email` string — The email address of the user
    - `admin` boolean — Whether the user has admin privileges
    - `workspace_owner` boolean — Whether the user is workspace owner

## Changes

- **2026-08-25** `fa785a68f09d` — 2 info
  - the security scope `SANDBOX_WRITE` was added to the endpoint's security scheme `oauth2`
  - the security scope `SANDBOX_MANAGE` was removed from the endpoint's security scheme `oauth2`

[Change history](https://skmtc.dev/buddy/apis/buddy-api/changes/workspaces/:workspace_domain/sandboxes/:sandbox_id/snapshots/post.md)

---

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