Skip to main content
POST
Execute a command against a browser session

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

session_ref
string
required

Opaque browser session reference (brs_)

Query Parameters

project_id
string<uuid>

Optional project ID for project sandbox scope (requires membership)

Body

application/json
argv
string[]
required

agent-browser command argv, forwarded verbatim.

Minimum array length: 1
Example:
stdin_json
any

Optional JSON value piped to the command's stdin.

timeout_ms
integer

Optional per-command timeout in milliseconds.

Response

The command's verbatim result envelope

success
boolean
required

Whether the command executed successfully (exit code 0).

data
any

Structured command result (shape varies by command); absent when the command emits no JSON.

error
string

Error detail when the command failed.

exit_code
integer

Process exit code of the command.

raw
string

Raw stdout when the command did not emit structured JSON.