Skip to main content
POST
Create Checkpoint
Create a checkpoint of the sandbox state. Each sandbox can have up to 10 full checkpoints and up to 100 disk-only checkpoints. By default, creating past the limit for that checkpoint type returns an error. Set retentionPolicy.mode to delete_oldest to delete the oldest eligible checkpoint of the same type first so the new checkpoint can be created.
string
required
Sandbox ID
string
required
Checkpoint name (unique per sandbox)
string
default:"full"
Checkpoint type. Use full to preserve disk, memory, and CPU state, or disk_only to preserve only disk state with a larger per-sandbox limit.
object
Optional retention policy. Use { "mode": "delete_oldest", "maxCount": 10 } for full checkpoints or { "mode": "delete_oldest", "maxCount": 100 } for disk-only checkpoints to delete the oldest eligible checkpoint of the same type before creating a new one.