Keep alive

Documentation Index

Fetch the complete documentation index at: https://docs.browserbase.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Why use keep alive?

• Reconnection workflows: Connect, disconnect, and reconnect to the same session
• Multiple connections: Different scripts or tools can connect to the same session
• Survive disconnects: Network issues won’t end your session
• Performance: Reconnecting to an existing session is faster than creating a new one
• Session reuse: Re-run scripts against the same session without recreating it
• Billing optimization: keep alive lets you avoid minimum browser usage charges if running many short-lived sessions (under 1 minute)

​

Using keep alive

​

Creating a keep alive session

import Browserbase from "browserbase";

const bb = new Browserbase({ apiKey: process.env.BROWSERBASE_API_KEY! });
const session = await bb.sessions.create({
  keepAlive: true,
});

// Reconnect later using the same connect URL
console.log("Connect URL:", session.connectUrl);

from browserbase import Browserbase
import os

bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])
session = bb.sessions.create(
  keep_alive=True
)

# Reconnect later using the same connect URL
print("Connect URL:", session.connect_url)

​

Releasing a keep alive session

await bb.sessions.update(session.id, {
  status: "REQUEST_RELEASE",
});

bb.sessions.update(
  session.id,
  status="REQUEST_RELEASE"
)

​

Keep alive and timeouts

const session = await bb.sessions.create({
  keepAlive: true,
  timeout: 3600, // 1 hour
});