Pause and resume a sandbox

Pause preserves a sandbox while stopping active compute charges where the provider supports it. Resume returns a paused sandbox to ready.

Provider support

Reliable pause and resume are available through CodeSandbox, E2B, Freestyle, Northflank, and Runloop. Other providers return capability_unsupported. Daytona pause reporting is currently inconsistent.

Pause

The sandbox must be ready. Keep the returned operation ID until it reaches a terminal state.

const mutation = await metal.sandboxes.pauseAsync(sandbox.id);
const operation = await metal.operations.wait(mutation.operation);

if (operation.state !== "succeeded") {
  throw new Error(operation.error?.message ?? `Pause ${operation.state}`);
}

Resume

The sandbox must be paused.

const mutation = await metal.sandboxes.resumeAsync(sandbox.id);
const operation = await metal.operations.wait(mutation.operation);

if (operation.state !== "succeeded") {
  throw new Error(operation.error?.message ?? `Resume ${operation.state}`);
}

Do not automatically submit the same lifecycle action again after an uncertain response. Inspect the sandbox and original operation before deciding how to recover.