Skip to main content
POST
/
api
/
sandboxes
/
from-checkpoint
/
{checkpointId}
Fork from Checkpoint
curl --request POST \
  --url https://app.opencomputer.dev/api/sandboxes/from-checkpoint/{checkpointId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "timeout": 123,
  "envs": {},
  "secretStore": "<string>",
  "memoryMB": 123
}
'
{
  "sandboxID": "sb-def456",
  "status": "running",
  "region": "use2",
  "workerID": "w-use2-abc123",
  "memoryMB": 4096
}
Create a new sandbox from a checkpoint.
​
checkpointId
string
required
Checkpoint ID
​
timeout
integer
Idle timeout for the new sandbox (default: 300)
​
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.
{
  "sandboxID": "sb-def456",
  "status": "running",
  "region": "use2",
  "workerID": "w-use2-abc123",
  "memoryMB": 4096
}