Skip to main content
POST
Move a snapshot to another storage

Authorizations

Authorization
string
header
required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Path Parameters

snapshot
string
required

The snapshot UUID

Example:

"2305595e-9b2f-4f9e-96d7-47fc7ff45791"

Body

application/json

Send a JSON object containing the fields below. Required fields are marked in the schema.

snapshot_storage
string<uuid>
required

The value of snapshot_storage.

Response

The record, as a JSON object. There is no envelope.

A saved copy of a server's disk state.

uuid
string
required

The uuid UUID.

Example:

"2305595e-9b2f-4f9e-96d7-47fc7ff45791"

name
string
required

The name shown to customers.

Example:

"Pre-cascade baseline"

status
enum<string>
required

The state as the customer reads it, including a suspension of the storage holding the snapshot.

Available options:
creating,
available,
failed,
unavailable,
suspended,
restoring
Example:

"available"

is_successful
boolean
required

Whether the resource is successful.

Example:

true

is_available
boolean
required

Whether the resource is available.

Example:

true

size
integer | null
required

The value of size.

Example:

85899345920

disk_allocated
integer | null
required

What the VM's disk was provisioned at when the snapshot was taken.

Example:

85899345920

disk_used
integer | null
required

How much of that disk is in use on the VM right now.

Example:

33822867456

completed_at
string<date-time> | null
required

The date and time for completed at, in UTC.

Examples:

"2026-09-03T04:21:17.000000Z"

"2026-09-12T22:07:13.000000Z"

created_at
string<date-time> | null
required

The date and time for created at, in UTC.

Examples:

"2026-09-03T04:21:17.000000Z"

"2026-09-12T22:05:47.000000Z"

server
SnapshotServerData · object | null
required

The machine it was taken of, while that machine exists and is still the same account's. A snapshot outlives its server, and one moved to another account with its storage does not reveal the seller's machine.

Example:
server_name
string | null
required

What the machine was called when the snapshot was taken.

Example:

"lambda-core"

storage
SnapshotStorageSummaryData · object | null
required

The snapshot storage holding it and paying for it.

Example: