Capture reusable sandbox state and restore it later through the current snapshots API. The current API supports snapshot creation in two ways:
  • POST /sandboxes/{id}/snapshots when you already have a sandbox ID
  • POST /snapshots when you want to work directly with the snapshots resource

​
What A Snapshot Is Used For

  • Restore a sandbox later with POST /snapshots/{id}/restore
  • Boot a sandbox from an existing snapshot through snapshotId
  • Persist state before TTL expiry or shutdown workflows

​
Minimal Example

curl -X POST https://api.agentenv.io/v1/snapshots \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sandboxId": "SANDBOX_ID",
    "name": "checkpoint-2026-03-24"
  }'
ActionEndpoint
List snapshotsGET /snapshots
Get one snapshotGET /snapshots/{id}
Update metadataPUT /snapshots/{id}
DeleteDELETE /snapshots/{id}
RestorePOST /snapshots/{id}/restore

​
API Pages