[masnwilliams]

Summary

Adds a "Read-only and control URLs" section to the live view page for the new POST /browsers/{id_or_name}/live_view endpoint:

• what read and control URLs allow
• TypeScript and Python examples with scope and ttl_seconds
• lifetime: ttl_seconds, browser deletion and pool release
• a note that read-only URLs need a recent browser image

It also mentions ttl_seconds under URL lifetime.

Before merging

• Merge once the POST /browsers/{id_or_name}/live_view endpoint is available in the API.
• Check the SDK method names (kernel.browsers.liveView.create / kernel.browsers.live_view.create) against the generated SDKs.

---

Note

Low Risk
Documentation-only updates with no runtime or API behavior changes in this diff.

Overview
Documents how to mint scoped live view URLs (read vs control) via the SDK instead of relying only on the default browser_live_view_url and the readOnly query param.

The new Read-only and control URLs section explains sharing patterns, shows TypeScript/Python examples with scope and ttl_seconds, and covers lifetime (default read, optional TTL/expires_at, pool release, and treating URLs as credentials). It adds a note that read-only scoped URLs need a recent browser image.

The URL lifetime section now states that scoped URLs also expire when ttl_seconds is set.

^{Reviewed by Cursor Bugbot for commit 326b019. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Nov 2, 2026, 5:54 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[andrewleesteele]

lgtm