POST /sandboxes/{sandboxID}/fork

Fork sandbox

Fork the sandbox: checkpoint the running sandbox in place (it is briefly paused, snapshotted with its full memory state, and resumed on its node, keeping its ID and expiration untouched) and create count new sandboxes from that snapshot. Returns one result per requested fork, each carrying either the created sandbox or the error that prevented it from starting. A non-201 status means the request failed before any fork was attempted.

Base URL: https://api.agentbox-runtime.ru.

Authorization: required header X-API-Key.

Parameters

sandboxID · string · path · required

Request body

Required: no

application/json

Schema: SandboxForkRequest

timeout · integer · optional
Time to live for the new forked sandboxes in seconds.
Format: int32
Default: 15
Minimum: 0
count · integer · optional
Number of forked sandboxes to create. All forks boot from the same snapshot, so the snapshot is captured once regardless of count. Each fork succeeds or fails independently; the outcome of each is reported in its entry of the response list.
Format: int32
Default: 1
Minimum: 1
Maximum: 100