---
title: "Synchronously create a disk snapshot of a running Devbox."
method: POST
path: "/v1/devboxes/{id}/snapshot_disk"
tags: ["Devbox", "Devbox-PersistenceTools"]
---

# Synchronously create a disk snapshot of a running Devbox.

`POST /v1/devboxes/{id}/snapshot_disk`

Create a disk snapshot of a devbox with the specified name and metadata to enable launching future Devboxes with the same disk state.

## Path parameters

- `id` string, required

## Request body

- DevboxSnapshotRequest
  - `name` string, nullable — (Optional) A user specified name to give the snapshot
  - `metadata` object, nullable — (Optional) Metadata used to describe the snapshot
  - `commit_message` string, nullable — (Optional) Commit message associated with the snapshot (max 1000 characters)

## Response `200`

Snapshot created successfully.

- DevboxDiskSnapshotView
  - `id` string, required — The unique identifier of the snapshot.
  - `name` string, nullable — (Optional) The custom name of the snapshot.
  - `create_time_ms` integer, required — Creation time of the Snapshot (Unix timestamp milliseconds).
  - `metadata` object, required — User defined metadata associated with the snapshot.
  - `source_devbox_id` string, required — The source Devbox ID this snapshot was created from.
  - `commit_message` string, nullable — (Optional) The commit message of the snapshot (max 1000 characters).

## Other responses

- `404` — Devbox not found.

## Changes

- **2025-10-15** `436b4f5c7426` — 2 info
  - added the new optional request property `commit_message`
  - added the optional property `commit_message` to the response with the `200` status

[Change history](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/devboxes/:id/snapshot_disk/post.md)

---

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