# Live view

Source: https://webagent-docs-staging.lookover.ai/concepts/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 [#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](/concepts/sessions).

## Take over [#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 [#share-a-link]

A share link lets anyone watch a session without an API key. Create one with the API.

> **Note: 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.

```bash title="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.

| 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 `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](/concepts/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.