v4

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-05-09283767.7 KB
snapshots

Get a snapshot

Returns the full Snapshot record for the given ID, scoped to the authenticated org. Used by the SDK's build() flow to fetch the completed snapshot after polling reports completed.

get/v1/snapshots/{id}

Response

Snapshot record

idstring required
namestring required
orgIdstring required
vmIdstring required
metadataMetadata

Free-form string→string map. Server-enforced limits: up to 256 keys, key length 1–256 bytes, value length ≤4096 bytes, total JSON encoding ≤65536 bytes.

envVarsEnvVars

Environment variable string→string map injected into the VM at boot. Keys must be 1–256 bytes and match shell-variable name ([A-Za-z_][A-Za-z0-9_]*); values may not contain newline, carriage return, or null bytes. Total JSON encoding ≤65536 bytes.

statusstring required

Snapshot lifecycle status. Known values: creating, ready, error. Additional values may be introduced in future server versions.

createdAtstring date-time required