---
title: "Update metadata of Disk Snapshot."
method: POST
path: "/v1/devboxes/disk_snapshots/{id}"
tags: ["Devbox", "Devbox-PersistenceTools"]
---

# Update metadata of Disk Snapshot.

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

Updates disk snapshot metadata via update vs patch. The entire metadata will be replaced.

## 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.
  - `source_blueprint_id` string, nullable — (Optional) The source Blueprint ID this snapshot was created from.
  - `commit_message` string, nullable — (Optional) The commit message of the snapshot (max 1000 characters).
  - `size_bytes` integer, nullable — (Optional) The size of the snapshot in bytes, relative to the base blueprint.

## Other responses

- `404` — Devbox not found.

---

[API](https://skmtc.net/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.net/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runloopai/runloop-api/versions/ef553a04de89/schema)