Skip to navigation
API Referencesandboxes

Start command

Start a command in an existing sandbox and receive an exec ID. The command runs asynchronously, so the response confirms that execution started rather than returning its output. Use the exec ID with the result endpoint to read stdout, stderr, exit code, and final status.

Path parameters

sandbox_namestringRequired
Sandbox name

Headers

X-Islo-Api-VersionstringRequired

Request

This endpoint expects an object.
commandlist of stringsRequired
Command to execute.
envmap from strings to strings or nullOptional
Environment variables to inject into this execution session.
timeout_secslong or nullOptional>=0

Optional client-side timeout hint. Currently accepted for API compatibility.

userstring or nullOptional

User to run the command as (e.g., “islo”). If not provided, uses image default.

workdirstring or nullOptional
Working directory for command execution inside the sandbox.

Response

Command execution started
exec_idstring
sandbox_idstring
statusstring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error