BROWSER USE

Products:
- [Browser Harness](https://browser-harness.com)
- [Stealth Browsers](https://browser-use.com/stealth-browsers)
- [Browser Use Box](https://browser-use.com/bux)
- [Web Agents](https://browser-use.com/web-agents)
- [Custom Models](https://browser-use.com/custom-models)
- [Proxies](https://browser-use.com/proxies)

[Pricing](https://browser-use.com/pricing)
[Blog](https://browser-use.com/posts)
[Cloud Docs](https://docs.cloud.browser-use.com)
[Open Source Docs](https://docs.browser-use.com)

[GET STARTED](https://cloud.browser-use.com)
[GITHUB](https://github.com/browser-use/browser-use)

---

# Recording Controls & OAuth Browser Access

**Date:** 2026-07-20
> Client-controlled browser recording on the Browser Harness API, plus OAuth read access to browsers.

---

## Recording Controls

The Browser Harness (v4) API now lets callers control session recording instead of it being always-on.

- `browserSettings.record` opts API calls into recording (off by default) or lets UI sessions opt out (on by default).
- An explicit `record` value always wins over the client default, and the setting is inherited by follow-up runs on the same browser.

```bash
curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "...", "browserSettings": {"record": true}}'
```

## OAuth

OAuth apps using the terminal flow can now read existing browsers — the `v3:browsers:read` scope joins the existing create and profile scopes.