Snapshots¶

Disk snapshots of a machine's root volume. Cloud product guide: Snapshots.

Base URL: https://api.sistemo.io · authentication required. Mutations need full scope.

Take¶

POST /v1/machines/{id}/snapshots

{ "name": "optional-label" }

curl -X POST "https://api.sistemo.io/v1/machines/$ID/snapshots" \
  -H "Authorization: Bearer $SISTEMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"before-change"}'

Returns the snapshot object (201).

created_at / updated_at are zero in the create response

A create returns "0001-01-01T00:00:00Z" for both — Go's zero time, not a real timestamp. The values are correct everywhere else, so read them from a subsequent GET rather than from the create response. Observed 2026-09-22.

List for machine¶

GET /v1/machines/{id}/snapshots

{ "snapshots": [ … ] }

List for account¶

GET /v1/snapshots

Restore¶

POST /v1/snapshots/{id}/restore

Machine must be stopped. Destructive in-place rollback. Fails if newer snapshots exist.

Delete¶

DELETE /v1/snapshots/{id}

409 if a machine was deployed from this snapshot and still depends on it.

Create machine from snapshot¶

POST /v1/machines

{ "name": "clone", "snapshot_id": "<uuid>" }

Placement is pinned to the snapshot's host. See Machines.

Delete machine with snapshots¶

DELETE /v1/machines/{id}?delete_snapshots=true

Without delete_snapshots=true, delete returns 409 if snapshots remain. See Machines — Delete.