API referenceChanging a session
Click or type on the screen
POST
One input for the sandbox's browser, from the person in control (403 from anyone else). Send them one at a time, in order. Never recorded.
bearerheader
AuthorizationBearer <token>An API token
id*stringA session id
application/json- body
input*|||Sent to the screen
curl -X POST 'http://127.0.0.1:7777/sessions/ses_6c1f2a0b9d3e4f5a6b7c/screen/input' \ -H 'Content-Type: application/json' \ -d '{ "input": { "type": "mouse", "action": "down", "x": 640, "y": 400 }}'Example Response
Empty
Hand the screen back POST
Control returns to the agent; `note` reaches it as your next message (once, however often you ask). The record shows who took over, for how long, and the note; never what was typed or shown.
Run a step again POST
Runs one earlier tool call again, with the same tool and arguments, as a step of its own; the model sees its result on the next turn. Only while the session is idle. The same `toolCallId` and `idempotencyKey` run it once.