Live view
Watch a running session in the dashboard, take over the browser, and share a link without an API key.
The live view shows a session's browser as it runs. You can watch what the agent does, take the controls, and send a link to someone who has no webagent account.
Watch in the dashboard
Open the dashboard at https://webagent.lookover.ai, go to Sessions and open a session. While the session is open, the page shows the live browser next to the task chat. You can watch a task from the first step.
The live view only exists while the session is open. A run_task call without keepOpen closes its session when the task ends, so you can watch it only during the task. To keep a session for later, open it with create_session or pass keepOpen: true. Stop it with stop_session when you are done. See Sessions.
Take over
Press Take over in the dashboard to pause the agent and use the browser yourself. While you hold the controls the session is paused. A task that is running stops with stoppedBy: "paused", and agent actions are refused with session_paused. Press Hand back to let the agent continue.
Share a link
A share link lets anyone watch a session without an API key. Create one with the API.
API address
The shell examples on this page use the variable API_URL. Set it once: export API_URL=https://api.us.webagent.lookover.ai. If your organization was given another API address, use that one instead. Set WEBAGENT_API_KEY to your API key.
curl -s -X POST $API_URL/v1/sessions/$SESSION_ID/share \
-H "Authorization: Bearer $WEBAGENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"live"}'The reply is { "url": "…", "expiresAt": "…" }. Send the url to the viewer.
| Field | Meaning |
|---|---|
kind | live (default) shows the running browser. replay plays the recording |
interactive | live only. true lets the viewer take control. Default false, view only |
ttlSeconds | How long the link works. 60 seconds up to 7 days. Default 3600 (one hour) |
Notes:
- A
livelink works only while the session is open. After the session ends, the link no longer opens. - A
replaylink needs a recording. Create the session withrecord: true. See Evidence. - Any key of the project can create a link.
DELETE /v1/sessions/:id/sharerevokes every link issued before that moment. Links you create afterwards work.- A link is a secret. Whoever has it can watch, and with
interactive: truecan control the browser. Use a shortttlSeconds.
Sharing is done through the REST API. There is no MCP tool for it.