POST
/
v1
/
sessions

Authorizations

X-BB-API-Key
string
headerrequired

Your Browserbase API Key.

Body

application/json
projectId
string
required

The Project ID. Can be found in Settings.

extensionId
string

The uploaded Extension ID. See Upload Extension.

browserSettings
object
timeout
integer

Duration in seconds after which the session will automatically end. Defaults to the Project's defaultTimeout.

keepAlive
boolean

Set to true to keep the session alive even after disconnections. This is available on the Startup plan only.

proxies

Proxy configuration. Can be true for default proxy, or an array of proxy configurations.

Response

201 - application/json
id
string
required
createdAt
string
required
updatedAt
string
required
projectId
string
required

The Project ID linked to the Session.

startedAt
string
required
endedAt
string
expiresAt
string
required
status
enum<string>
required
Available options:
RUNNING,
ERROR,
TIMED_OUT,
COMPLETED
proxyBytes
integer
required

Bytes used via the Proxy

avgCpuUsage
integer

CPU used by the Session

memoryUsage
integer

Memory used by the Session

keepAlive
boolean
required

Indicates if the Session was created to be kept alive upon disconnections

contextId
string

Optional. The Context linked to the Session.

Was this page helpful?

List SessionsSession