Browserbase is a serverless platform that enables developers to run, manage, and monitor headless browsers at scale, offering seamless integration with tools like Playwright, Puppeteer, and Selenium.
Attach an existing project secret to a Function by UUID. Takes effect on the Function's next invocation. Re-attaching an already attached secret succeeds. Returns a local success confirmation for HTTP 204 No Content, HTTP 400 for invalid UUIDs, or HTTP 404 if the Function or secret does not exist in the project.
Deprecated compatibility action. Use CREATE_CONTEXT.
Deprecated compatibility action. Use GET_CONTEXT.
Create a reusable browser context; the API key can select the project.
Deprecated compatibility action. Use CREATE_SESSION.
Create an isolated Browserbase session and return its connection details.
Create a reusable browser agent with a name and optional system prompt and result schema. Use the returned agentId when starting runs to reuse its configuration. An agent without a system prompt behaves like an unconfigured run.
Register a publicly reachable HTTPS endpoint for project event deliveries. An endpoint can only be registered once per project. Store the signing secret returned here: it is only shown on creation and secret rotation.
Tool to delete a browser context and all its stored data (cookies, localStorage, etc.). Use when you need to permanently remove a context.
Tool to delete an uploaded browser extension by its ID. Use when you need to remove an extension from Browserbase.
Delete a reusable browser agent by its agentId. Runs that already referenced the agent are unaffected. Deleting an already-deleted or nonexistent agent also succeeds. Returns an empty result.
Delete a webhook, immediately stopping deliveries and retiring its secret. Earlier events are not replayed if the endpoint is registered again.
Delete a download file from storage and mark it as deleted. Supply the download ID. Returns an empty object on success.
Tool to delete all file downloads from a specific browser session. Use when you need to clean up session artifacts or free storage space.
Detach a project secret from a Function by UUID. Takes effect on the Function's next invocation. Detaching a secret that is not attached succeeds. Returns a local success confirmation for HTTP 204 No Content, HTTP 400 for invalid UUIDs, or HTTP 404 if the Function does not exist in the project. Does not delete the project secret.
Download a completed session's generated files as a ZIP archive.
Fetch a page and return its content, headers, and metadata.
Return metadata for a browser context by ID.
Return status, connection details, and timestamps for a browser session.
Retrieve a reusable browser agent by its agentId. Returns its name, timestamps, and configured system prompt and result schema.
Retrieve a browser agent run's current status, result, and session details. Use List Run Messages separately to retrieve the run's messages.
Retrieve a Browserbase function by its ID. Returns its name, owning project ID, and creation and update timestamps.
Retrieve a Browserbase function build by its build ID. Returns its status, original request, timestamps, and produced functions and versions or failure cause when available.
Retrieve Browserbase function build logs by the build ID. Returns log messages, their numeric timestamps, and the total log count.
Retrieve a Browserbase function version by its version ID. Returns its project, function, build, timestamps, and configured session creation parameters and user parameter schema when present.
Retrieve a Browserbase function invocation by its invocation ID. Returns its status, function and session IDs, timestamps, and execution region, parameters, results, and failure cause when present.
Retrieve Browserbase function invocation logs by the invocation ID. Returns log messages, their numeric timestamps, and the total log count.
Retrieve the project's public HPKE encryption key and keypair ID. Use publicKey to encrypt secret values before creating a secret, and pass the returned id as keypairId so decryption supports keypair rotation.
Return project metadata, default timeout, and assigned concurrency.
Retrieve a project secret's ID and name by UUID, without its secret value. Returns HTTP 400 for an invalid UUID and HTTP 404 if the secret does not exist in the project.
Retrieve a single webhook by ID, without its signing secret. The signing secret is only returned when creating a webhook or rotating it.
Retrieve a Browserbase certificate by its ID. Returns the certificate's ID, creation and update timestamps, and project ID.
Get a single download by ID as metadata or a downloadable file object. Select application/json for metadata or application/octet-stream for the file. This retrieves one file, rather than the ZIP of all session artifacts.
Tool to retrieve usage statistics for a project including browser minutes and proxy bytes consumed. Use when you need to monitor or track resource usage for a specific project.
Return live debugger and WebSocket URLs for a running browser session.
Return network request and response events captured during a browser session.
Return HLS replay metadata and page playlist paths for a recorded session.
Return the HLS M3U8 playlist for one recorded replay page. Consume its short-lived signed media URLs promptly rather than storing them.
Invoke a deployed Browserbase function asynchronously. Returns the accepted invocation (HTTP 202), not its eventual result. Optionally pass function parameters and configure its browser session.
List browser sessions, optionally filtered by status or user metadata.
List a page of browser agent runs across your account. Filter by status, referenced agent, or inclusive creation-time bounds. Continue pagination by passing the returned nextCursor as cursor.
List one page of reusable browser agents across your account. Filter by inclusive creation timestamps using startAt and endAt. Pass the returned nextCursor as cursor to continue paging until nextCursor is null.
List one page of download metadata for a required browser session. Filter by exact filename, MIME type, file size, or inclusive creation timestamps. Use limit and offset to paginate through the total matches.
List one page of Browserbase function builds, optionally filtered by status. Use offset and limit to paginate; total reports the number of matching builds. Results include build status, timestamps, and any built functions or failure cause.
List one page of secret IDs and names attached to a Browserbase function, optionally filtered by creation time. Pass nextCursor as cursor with the same filters to continue paging; a null nextCursor means there are no more results.
List one page of invocations for a Browserbase function version by its UUID. Filter by status and paginate using offset and limit. Each invocation includes its status, function and session IDs, timestamps, and any stored results.
List one page of versions for a Browserbase function by its UUID. Use offset and limit to page through results; total reports the total number of versions. Each version includes its build ID and stored parameter schemas.
List one page of Browserbase functions and the total number available. Use offset and limit to paginate. Pass a returned function id to invoke it.
List projects with their default timeout and assigned concurrency.
List a page of a browser agent run's messages, oldest first, with assistant or tool roles and text or typed content parts. Pass nextSince as since to continue paging or poll for new messages; use all to ignore the page limit.
List one page of project secret IDs and names, optionally filtered by creation time. Does not return secret values. Pass nextCursor as cursor to fetch the next page; a null nextCursor means there are no more results. Time bounds are inclusive.
List one page of the project's webhooks, newest first, without signing secrets. Pass nextCursor as cursor to fetch the next page. A null nextCursor ends paging.
List Browserbase certificates with their IDs, timestamps, and project IDs.
Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED. Completed standard-storage pages may include short-lived signed MP4 URLs; BYOS pages may complete without a URL.
Irreversibly request release of a running browser session, ending it before its configured timeout to avoid further charges.
Start asynchronous MP4 assembly for every recorded page of a completed session, then poll List Recording Downloads until every page is COMPLETED or FAILED.
Resume only a PAUSED browser agent run with optional additional input. The task answers its trailing pause tool call; variables merge over the run's original variables. A run that is not PAUSED returns HTTP 409 conflict. Returns the accepted RUNNING run; poll the run for its next state.
Tool to retrieve details of a specific browser extension. Use when you have an extension ID and need its metadata (file name, timestamps, project ID).
Start a browser agent run to complete a task using web search and browser tools. Returns the newly created pending run, not its eventual result. Optionally use a custom agent, configure its browser, supply variables, or enable pauses.
Deprecated compatibility action. Use GET_SESSION.
Deprecated compatibility action. Use GET_SESSION_DEBUG_URLS.
Deprecated compatibility action. Use DOWNLOAD_SESSION_ARTIFACTS.
Deprecated compatibility action. Use GET_SESSION_LOGS.
Deprecated compatibility action. Use LIST_SESSIONS.
Deprecated compatibility action. Use RELEASE_SESSION.
Request that an in-progress browser agent run stop. Returns the run after the stop request is accepted, not confirmation that it has stopped. The run winds down and transitions to STOPPED; poll Get Run until its status is STOPPED to confirm. Already-finished runs return HTTP 409 conflict.
Tool to update a specific browser context. Use when you need fresh upload URL and encryption details for an existing context, after obtaining a valid context ID.
Update a reusable browser agent's name, system prompt, or result schema. Only supplied fields are modified; omitted fields remain unchanged. Returns the updated agent, whose defaults apply to subsequent runs referencing it.
Update a webhook's delivery URL, subscribed event types, or both. Omitted fields stay unchanged. Event types replace the existing subscription rather than adding to it. The signing secret is unaffected and not returned.
Tool to upload a browser extension for use in sessions. Supports Chrome extension format (ZIP). Use when you need to add custom browser extensions to your Browserbase project.
Upload one file so browser interactions can select it in a file input field.
Upload multiple files to one browser session for file-input interactions. Reports per-file outcomes when at least one upload succeeds; a batch-level provider error can stop further attempts.
Perform a web search and return structured results.
The Browserbase integration connects your Dench AI CRM directly to Browserbase, so agents can read and act on your Browserbase data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
73 actions are available for agents to invoke on your behalf. Every call runs through Browserbase's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find Browserbase and click Connect — you'll authorize access through Browserbase's own sign-in flow. No API keys or code required.
Ask an agent to use Browserbase in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench Browserbase integration connects your AI CRM to Browserbase, so AI agents can work with your Browserbase data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The Browserbase integration currently exposes 73 actions, including Attach Browserbase Function Secret, Contexts create, Contexts get, Create Browser Context, Create browser session, and Create Browser Session. Agents invoke them on your behalf from chat or from automations.
No. You connect Browserbase from your Dench workspace using Browserbase's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through Browserbase's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Browserbase connection from your workspace settings at any time.