Browserbase sessions die on disconnect unless you set keepAlive

Browserbase sessions die on disconnect unless you set keepAlive

TL;DR

Sessions end when you disconnect unless keepAlive=true is set at creation. Set it if you need to reconnect mid run, and remember the timeout is in seconds (60 to 21600). Context: Official docs (Browserbase create a session API reference): a session is torn down when the client disconnects by default.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

If your automation drops its CDP connection and you want to reconnect to the same browser, pass keepAlive=true when you create the session. Note keepAlive needs a Hobby or Scale plan. Also the timeout is in seconds, minimum 60 and maximum 21600, and the connectUrl you get back is the CDP endpoint you hand to Playwright or Puppeteer.

Source: Official docs (Browserbase create a session API reference): a session is torn down when the client disconnects by default. If your automation drops its CDP connection and you want to reconnect to the same browser, pass keepAlive=true when you create the session. Note keepAlive needs a Hobby or Scale plan. Also the timeout is in seconds, minimum 60 and maximum 21600, and the connectUrl you get back is the CDP endpoint you hand to Playwright or Puppeteer.

Verified resolution: Sessions end when you disconnect unless keepAlive=true is set at creation. Set it if you need to reconnect mid run, and remember the timeout is in seconds (60 to 21600).

Source URL: https://docs.browserbase.com/reference/api/create-a-session