Skip to Content
webagent docs
Concepts

Live view

Watch a running session in the dashboard, take over the browser, and share a link without an API key.

Open as .md

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.

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.

A view-only live link for one hour
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.

FieldMeaning
kindlive (default) shows the running browser. replay plays the recording
interactivelive only. true lets the viewer take control. Default false, view only
ttlSecondsHow long the link works. 60 seconds up to 7 days. Default 3600 (one hour)

Notes:

  • A live link works only while the session is open. After the session ends, the link no longer opens.
  • A replay link needs a recording. Create the session with record: true. See Evidence.
  • Any key of the project can create a link.
  • DELETE /v1/sessions/:id/share revokes every link issued before that moment. Links you create afterwards work.
  • A link is a secret. Whoever has it can watch, and with interactive: true can control the browser. Use a short ttlSeconds.

Sharing is done through the REST API. There is no MCP tool for it.

On this page