Skip to main content
POST
Fork from Checkpoint
Create a new sandbox from a checkpoint.
checkpointId
string
required
Checkpoint ID
timeout
integer
Idle timeout for the new sandbox (default: 0 — persistent, never auto-hibernates)
envs
object
Environment variables to override on the fork. Keys that match the checkpoint’s stored envs are replaced; new keys are added.
secretStore
string
Name of a secret store to attach. If the checkpoint already has a store, secrets are merged — the new store’s values win on collision and egress allowlists are aggregated.
memoryMB
integer
Memory for the forked sandbox, in MB. Clamped to a valid range: the floor is the checkpoint’s own memory (a fork can’t start smaller than the snapshot it restores, so a smaller value is ignored) and the ceiling is 16384 (16 GB; larger values are capped). The memoryMB field in the response reports the effective value after clamping.