v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Snapshots

Restore snapshot

Revert the source VM (or volume) to the state captured in this snapshot.

For VM snapshots, the VM must be in passive state (powered off) before calling this endpoint.

After a successful restore, this snapshot's status flips to active and the previously-active snapshot (if any) is cleared. An active snapshot cannot be deleted — restore the source to a different snapshot first, or take a fresh one.

post/api/v1/snapshots/{id}/restore

Path parameters

idinteger required

Snapshot ID

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Response

Snapshot restore initiated

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Operation completed successfully"
}