Recording Controls & OAuth Browser Access

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.
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.