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.

Базовый URL: https://api.agentbox-runtime.ru.

Авторизация: обязательный заголовок X-API-Key.

Параметры

sandboxID · string · путь · обязательно

Тело запроса

Обязательно: нет

application/json

Схема: SandboxForkRequest

timeout · integer · необязательно
Time to live for the new forked sandboxes in seconds.
Формат: int32
По умолчанию: 15
Минимум: 0
count · integer · необязательно
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.
Формат: int32
По умолчанию: 1
Минимум: 1
Максимум: 100