Live View - Upstash Documentation

Every tab can produce a live view URL: a shareable link that streams the tab in real time. Open it in any browser, or embed it in an <iframe> to show your users what their agent is doing.

const liveUrl = await tab.liveViewUrl()

console.log(liveUrl)
// https://<box>-9223.<domain>/screencast?token=…&tab=…

live_url = tab.live_view_url()

print(live_url)
# https://<box>-9223.<domain>/screencast?token=…&tab=…

The URL is self-contained. Authentication is a token embedded in the URL itself, so it works anywhere a browser can load a page. The viewing side needs no API key and no SDK.

Embedding

<iframe
  src="https://<box>-9223.<domain>/screencast?token=…&tab=…"
  style="width: 100%; aspect-ratio: 16 / 10; border: 0;"
></iframe>

A common pattern is to render the live view next to your own act/observe/extract loop, so users can watch the browser respond in real time.

View-only

The live view streams frames out only. Viewers cannot click, type, or otherwise interact with the page. To drive the browser, use the SDK or connect over CDP. If you need an interactive viewer inside your own product, you can build one over CDP by streaming screencast frames out and sending input events back. This is how the console’s browser tab works.

Anyone with the URL can watch the tab, since the access token is part of the URL. Treat live view URLs like secrets and share them only with people who should see the session.

For an interactive version of the same view, open the Browser tab on your box’s page in the Upstash Console. If you want a replayable video instead of a live stream, see Recordings.

​Embedding

​View-only

Embedding

View-only