Snapshots and cloning

Capture reproducible checkpoints and start new sandboxes from the right state.

A snapshot captures a prepared environment so future runs do not repeat bootstrap work. Use a descriptive name that identifies the dependency or agent version it represents.

Snapshot creation and deletion require machine-update permission; listing a sandbox's snapshots only needs read access. The API returns a pending snapshot until it is ready to use as a source for new sandboxes.

1curl -X POST "$ZEISH_API/public/sandboxes/$SANDBOX_ID/snapshots" \2  -H "Authorization: Bearer $ZEISH_API_KEY" \3  -H "Content-Type: application/json" \4  -d '{"displayName":"agent-base-v1"}'56curl "$ZEISH_API/public/sandboxes/$SANDBOX_ID/snapshots" \7  -H "Authorization: Bearer $ZEISH_API_KEY"