v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-016917.1 KB

Exec Command

Run a command inside a sandbox and return its result.

Resolves the sandbox (reconnecting on a registry miss), then runs the command over the facade's cached SSH channel.

post/sandboxes/{sandbox_id}/exec

Path parameters

sandbox_idstring required

Request body

commandstring required

Shell command to execute in the sandbox.

timeoutinteger

Maximum seconds to wait for the command to finish.

shell'login' | 'raw'

'login' runs via the guest login shell; 'raw' executes the command directly with no shell wrapping.

Response

Successful Response

exit_codeinteger required
stdoutstring required
stderrstring required