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

# Create snapshot

`POST /snapshots/{boxId}`

Create a snapshot of a running box. This snapshot will be saved and can be used to restore the box to the state it was in at the time the snapshot was created.

## Path parameters

- `boxId` string, required

## Request body

- CreateSnapshot — Create snapshot configuration
  - `name` string, required — Name of the snapshot. This name must be unique within the organization.

## Response `201`

Create snapshot

- Snapshot — Snapshot configuration
  - `id` string, required — Unique identifier for the snapshot
  - `name` string, required — Name of the snapshot. This name must be unique within the organization.
  - `boxType` 'linux' | 'android', required — The type of the box that the snapshot is taken from
  - `providerType` 'vm', required — The provider type of the snapshot
  - `status` 'Pending' | 'Available' | 'Error', required — The status of the snapshot

## Changes

- **2025-11-05** `8846b7e7a888` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/babelcloud/apis/gbox-open-api/changes/snapshots/:boxId/post.md)

---

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