Skip to main content
POST
Error

Authorizations

X-API-Key
string
header
required

Path Parameters

sandbox_id
string
required

Sandbox ID or name

Body

application/json
command
string[]

Command accepts either a shell command string or an argv string array.

command_id
string

CommandID makes the request idempotent: a known ID attaches to that running command instead of starting a second one.

cwd
string
deprecated

Deprecated: use run_config.work_dir. Rejected when run_config is also set.

env
object
deprecated

Deprecated: use run_config.env_vars. Rejected when run_config is also set.

idle_timeout_seconds
integer

0 = default, -1 = never idle-kill

run_config
object

RunConfig overrides, for this command only, the user, working directory and env the sandbox's commands run with.

shell
string
stdin
string<byte>

Stdin is the process's entire standard input, base64 on the wire. It is written once when the command is spawned and then closed, so the process reads EOF; there is no stdin streaming on this endpoint.

timeout_seconds
integer

0 = no timeout

ttl_seconds
integer

0 = default, -1 = keep forever

Response

SSE event stream

The response is of type string.