Browserbase
Create and inspect Browserbase cloud browser sessions and contexts.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
Browserbase
API Key
Browserbase
Connect to Browserbase cloud browser sessions with an API key.
Set up in Browserbase
Prepare the Browserbase account or service that the workflow will access. Grant access to the required resources and operations.
API Key: Copy an API key from the Browserbase dashboard.
Set up in StackAI
Open Settings → Connections, add a connection, and select Browserbase.
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required Browserbase action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Create Session
Start a Browserbase cloud browser session with safe, commonly used controls.
Inputs
Timeout (seconds)
integer
No
How long the session may run before Browserbase ends it; leave blank to use the project default. Minimum: 60. Maximum: 21600.
Region
select (string)
No
The Browserbase region where the browser should run. Available values: US West (Oregon), US East (Virginia), Europe (Frankfurt), Asia Pacific (Singapore). Default: us-west-2.
Context ID
string
No
Reuse cookies and browser storage from an existing Browserbase context.
Persist Context Changes
boolean
No
Save cookies and browser storage back to the selected context when the session ends. Default: false.
Record Session
boolean
No
Allow Browserbase to record the session for later review. Default: true.
Use Browserbase Proxy
boolean
No
Route browser traffic through Browserbase's managed proxy network. Default: false.
Allowed Domains
string
No
Comma-separated domains that top-level page navigation may visit.
Correlation ID
string
No
A caller-chosen unique value used to find a session after an uncertain network outcome.
Outputs
Session ID
string
The created Browserbase session identifier.
Status
select
The session lifecycle state.
Created At
datetime
When Browserbase created the session.
Started At
datetime
When the browser session started.
Expires At
datetime
When Browserbase will end the session.
Region
select
The region running the browser.
Context ID
string
The context linked to the session, when present.
Get Session
Get sanitized lifecycle details for one Browserbase session.
Inputs
Session ID
select (string)
Yes
The Browserbase session to inspect. Options load from the selected connection.
Outputs
Session
object
Sanitized lifecycle metadata for the session.
List Sessions
List sanitized Browserbase sessions with optional lifecycle or StackAI correlation filters.
Inputs
Status
select (string)
No
Return only sessions in this lifecycle state. Available values: Pending, Running, Error, Timed Out, Completed.
Correlation ID
string
No
Find sessions created with a specific StackAI correlation value.
Maximum Results
integer
No
Limit how many sanitized session summaries are retained in the workflow output. Minimum: 1. Maximum: 100. Default: 50.
Outputs
Sessions
object_array
Sanitized session summaries up to the requested cap.
Truncated
boolean
Whether more provider results existed than were returned.
Returned Count
integer
How many session summaries were returned.
Get Session Recording
Get per-page recording state and signed download references for completed pages.
Inputs
Session ID
select (string)
Yes
The completed Browserbase session whose recording to retrieve. Options load from the selected connection.
Outputs
Recording Pages
object_array
Per-page assembly states. A completed page's download_url is a time-limited signed URL granting access to session recording media, which may contain credentials typed into pages, and is persisted in the workflow run output.
Create Context
Create a named Browserbase context for reusable cookies and browser storage.
Inputs
Context Name
string
Yes
A unique name that identifies the reusable browser context.
Outputs
Context ID
string
The created Browserbase context identifier.
Request Session Recording Assembly
Request one MP4 assembly job per recorded page of a completed session.
Inputs
Session ID
select (string)
Yes
The completed Browserbase session whose recording to assemble. Options load from the selected connection.
Outputs
Recording Pages
object_array
The recorded pages Browserbase accepted for MP4 assembly.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?