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

## 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.

## Other responses

- `404` — Devbox not found.

---

[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/d1cc15eb5ef9/schema)