checkpoints

List all checkpoints.

Changed on

Returns every checkpoint the caller owns, newest first, including those whose machine has since been deleted (machineDeleted), which stay restorable until deleted themselves. Requires the machine:read scope.

get/v1/checkpoints

Request

Response

Portable checkpoints

archstring required
createdAtstring required
downloadUrlstring required

Authenticated endpoint that downloads the .smolcheckpoint file.

engineVersionstring nullable

smolvm version of the node that captured it. A restore is only placed on a node at this version or newer. Absent for older checkpoints, which restore anywhere.

idstring required
machineDeletedboolean

The machine it was captured from has been deleted. The checkpoint stays until it is deleted itself, and can still be restored or downloaded.

machineIdstring required
sizeBytesinteger required
statusstring required

creating, uploading, available, failed, or deleting.

Changes