Execute command with streaming

Execute a command inside a sandbox and stream stdout/stderr as SSE.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

sandbox_namestringRequired

Request

This endpoint expects an object.

commandlist of stringsRequired

Command to execute

workdirstring or nullOptional

Working directory for command execution inside the sandbox

envmap from strings to strings or nullOptional

Environment variables to inject into this execution session

sessionstring or nullOptional

Tmux session name. For POST /exec, creates a detached tmux session (replace semantics - kills any existing session with the same name). For WebSocket /exec, uses attach-or-create semantics (interactive). Ignored for POST /exec/stream.

userstring or nullOptional

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

Response

Successful Response

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

1	curl -X POST /sandboxes/sandbox_name/exec/stream \
2	-H "Authorization: Bearer <api_key>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"command": [
6	"ls",
7	"-la",
8	"/app"
9	]
10	}'

1	{
2	"event": "stdout",
3	"data": "total 48\ndrwxr-xr-x 5 root root 4096 Apr 26 12:00 .\ndrwxr-xr-x 1 root root 4096 Apr 26 11:59 ..\n-rw-r--r-- 1 root root 220 Apr 26 11:59 .bash_logout\n-rw-r--r-- 1 root root 3771 Apr 26 11:59 .bashrc\n-rw-r--r-- 1 root root 807 Apr 26 11:59 .profile\n"
4	}