Hand the screen back
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.
bearerAuthorizationBearer <token>An API token
id*stringA session id
application/json- body
note?stringFor the agent, at most 4000 characters
The agent controls it
application/json- response
holder*unknowncurl -X POST 'http://127.0.0.1:7777/sessions/ses_6c1f2a0b9d3e4f5a6b7c/control/return' \ -H 'Content-Type: application/json' \ -d '{ "note": "Signed in; carry on from the dashboard."}'{ "holder": "agent"}Take over the screen POST
You control the sandbox's screen until you hand it back or have been gone for the server's `screen.returnAfter`; asking again renews it. The agent's screen actions wait meanwhile, durably. The session's owner or an admin may. 409 while someone else controls it, or when the agent's screen action in flight doesn't end within 15 s.
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.