> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Browserbase

> 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.

![Browserbase logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/browserbase_tool.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=7f54811a0c8ace7065de3615cc991f13)

* **Category:** web scraping & browser
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 73
* **Triggers:** 0
* **Slug:** `BROWSERBASE_TOOL`
* **Version:** 20261101\_00

## Tools

> [accordion] Attach Browserbase Function Secret
>
> **Slug:** `BROWSERBASE_TOOL_ATTACH_FUNCTION_SECRET`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the Function to attach the secret to.
>
> **secretId** `string` *required*
>
> The UUID of the project secret to attach (the id returned by POST /v1/secrets). Re-attaching an already-attached secret succeeds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Contexts create
>
> **Slug:** `BROWSERBASE_TOOL_CONTEXTS_CREATE`
>
> Deprecated compatibility action. Use CREATE\_CONTEXT.
>
> #### Input Parameters
>
> **projectId** `string` *required*
>
> The Project ID. Can be found in Settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Contexts get
>
> **Slug:** `BROWSERBASE_TOOL_CONTEXTS_GET`
>
> Deprecated compatibility action. Use GET\_CONTEXT.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser context to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Browser Context
>
> **Slug:** `BROWSERBASE_TOOL_CONTEXTS_UPDATE`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the browser context to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Browserbase Agent
>
> **Slug:** `BROWSERBASE_TOOL_CREATE_AGENT`
>
> 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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name identifying the agent in the dashboard and API responses.
>
> **resultSchema** `object`
>
> JSON Schema that runs using this agent aim to conform their result to. Can be overridden per run.
>
> **systemPrompt** `string`
>
> System prompt steering the agent's behavior on every run that uses it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create browser session
>
> **Slug:** `BROWSERBASE_TOOL_CREATE_BROWSER_SESSION`
>
> Deprecated compatibility action. Use CREATE\_SESSION.
>
> #### Input Parameters
>
> **region** `string`
>
> Region for the session, e.g. 'us-west-2', 'us-east-1'.
>
> **proxies** `object`
>
> Optional proxy configuration for the session.
>
> **timeout** `integer`
>
> Session timeout in seconds.
>
> **keepAlive** `boolean`
>
> Whether to keep the session alive after disconnection.
>
> **projectId** `string` *required*
>
> Project ID to associate with the browser session.
>
> **extensionId** `string`
>
> The ID of the custom extension to load.
>
> **userMetadata** `object`
>
> Custom metadata object for the session. All values must be strings. The entire metadata object is limited to 512 characters when serialized to JSON. Note: The API has been observed to reject certain string patterns including URLs and strings containing '://' - use simple alphanumeric strings with underscores/hyphens. Examples: \{'purpose': 'navigation', 'env': 'staging', 'testId': 'test-123'}.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Browser Context
>
> **Slug:** `BROWSERBASE_TOOL_CREATE_CONTEXT`
>
> Create a reusable browser context; the API key can select the project.
>
> #### Input Parameters
>
> **name** `string`
>
> User-defined context name, unique within the project (1 to 128 characters)
>
> **projectId** `string`
>
> Project for the context; inferred from the API key when omitted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Browser Session
>
> **Slug:** `BROWSERBASE_TOOL_CREATE_SESSION`
>
> Create an isolated Browserbase session and return its connection details.
>
> #### Input Parameters
>
> **region** `string ("us-west-2" | "us-east-1" | "eu-central-1" | "ap-southeast-1")`
>
> Browserbase region in which to run the session
>
> **proxies** `string`
>
> Use the default proxy or route domains through explicit proxy configurations
>
> **timeout** `integer`
>
> Maximum session duration in seconds (60 to 21600)
>
> **keepAlive** `boolean`
>
> Keep the session running after clients disconnect
>
> **projectId** `string`
>
> Project for the session; inferred from the API key when omitted
>
> **extensionId** `string`
>
> Uploaded browser extension ID to load in the session
>
> **userMetadata** `object`
>
> Arbitrary metadata used to identify and filter the session
>
> **proxySettings** `object`
>
> Supplementary proxy certificate settings
>
> **browserSettings** `object`
>
> Browser behavior, identity, recording, and viewport settings
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Browserbase Webhook
>
> **Slug:** `BROWSERBASE_TOOL_CREATE_WEBHOOK`
>
> 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.
>
> #### Input Parameters
>
> **endpoint** `string` *required*
>
> HTTPS URL that event deliveries are POSTed to. Must be publicly reachable.
>
> **eventTypes** `array` *required*
>
> Unique event types this webhook subscribes to. Unknown types are rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Browserbase Agent
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_AGENT`
>
> 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.
>
> #### Input Parameters
>
> **agentId** `string` *required*
>
> The agent ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a browser context
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_CONTEXT`
>
> Tool to delete a browser context and all its stored data (cookies, localStorage, etc.). Use when you need to permanently remove a context.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser context to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Download
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_DOWNLOAD`
>
> Delete a download file from storage and mark it as deleted. Supply the download ID. Returns an empty object on success.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The download ID to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a browser extension
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_EXTENSION`
>
> Tool to delete an uploaded browser extension by its ID. Use when you need to remove an extension from Browserbase.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser extension to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Session Downloads
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_SESSION_DOWNLOADS`
>
> Tool to delete all file downloads from a specific browser session. Use when you need to clean up session artifacts or free storage space.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to delete downloads from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Browserbase Webhook
>
> **Slug:** `BROWSERBASE_TOOL_DELETE_WEBHOOK`
>
> Delete a webhook, immediately stopping deliveries and retiring its secret. Earlier events are not replayed if the endpoint is registered again.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The webhook ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Detach Browserbase Function Secret
>
> **Slug:** `BROWSERBASE_TOOL_DETACH_FUNCTION_SECRET`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the Function to detach the secret from.
>
> **secretId** `string` *required*
>
> The UUID of the project secret to detach. Detaching a secret that is not attached succeeds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Session Artifacts
>
> **Slug:** `BROWSERBASE_TOOL_DOWNLOAD_SESSION_ARTIFACTS`
>
> Download a completed session's generated files as a ZIP archive.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to download artifacts from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Browserbase Page
>
> **Slug:** `BROWSERBASE_TOOL_FETCH_PAGE`
>
> Fetch a page and return its content, headers, and metadata.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL to fetch
>
> **format** `string ("raw" | "json" | "markdown")`
>
> Output format for the response content. `raw` (default) returns the response body unchanged; `json` returns structured data (requires `schema`); `markdown` returns the page as markdown.
>
> **schema** `object`
>
> JSON Schema describing the desired structure of the response. Only used when `format` is `json`.
>
> **proxies** `boolean`
>
> Whether to enable proxy support for the request
>
> **contextId** `string`
>
> ID of a context whose persisted cookies are sent with the request.
>
> **allowRedirects** `boolean`
>
> Whether to follow HTTP redirects
>
> **allowInsecureSsl** `boolean`
>
> Whether to bypass TLS certificate verification
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Agent
>
> **Slug:** `BROWSERBASE_TOOL_GET_AGENT`
>
> Retrieve a reusable browser agent by its agentId. Returns its name, timestamps, and configured system prompt and result schema.
>
> #### Input Parameters
>
> **agentId** `string` *required*
>
> The agent ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Certificate
>
> **Slug:** `BROWSERBASE_TOOL_GET_CERTIFICATE`
>
> Retrieve a Browserbase certificate by its ID. Returns the certificate's ID, creation and update timestamps, and project ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the certificate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browser Context
>
> **Slug:** `BROWSERBASE_TOOL_GET_CONTEXT`
>
> Return metadata for a browser context by ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser context
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Download
>
> **Slug:** `BROWSERBASE_TOOL_GET_DOWNLOAD`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The download ID.
>
> **accept** `string ("application/json" | "application/octet-stream")`
>
> Return JSON metadata (default) or a downloadable file object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve a browser extension
>
> **Slug:** `BROWSERBASE_TOOL_GET_EXTENSION`
>
> 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).
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser extension to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Function
>
> **Slug:** `BROWSERBASE_TOOL_GET_FUNCTION`
>
> Retrieve a Browserbase function by its ID. Returns its name, owning project ID, and creation and update timestamps.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the function to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Function Build
>
> **Slug:** `BROWSERBASE_TOOL_GET_FUNCTION_BUILD`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The function build ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Function Build Logs
>
> **Slug:** `BROWSERBASE_TOOL_GET_FUNCTION_BUILD_LOGS`
>
> Retrieve Browserbase function build logs by the build ID. Returns log messages, their numeric timestamps, and the total log count.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The function build ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Function Version
>
> **Slug:** `BROWSERBASE_TOOL_GET_FUNCTION_VERSION`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The function version ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Invocation
>
> **Slug:** `BROWSERBASE_TOOL_GET_INVOCATION`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The invocation ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Invocation Logs
>
> **Slug:** `BROWSERBASE_TOOL_GET_INVOCATION_LOGS`
>
> Retrieve Browserbase function invocation logs by the invocation ID. Returns log messages, their numeric timestamps, and the total log count.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The function invocation ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Keypair
>
> **Slug:** `BROWSERBASE_TOOL_GET_KEYPAIR`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Project
>
> **Slug:** `BROWSERBASE_TOOL_GET_PROJECT`
>
> Return project metadata, default timeout, and assigned concurrency.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the Browserbase project
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project usage statistics
>
> **Slug:** `BROWSERBASE_TOOL_GET_PROJECT_USAGE`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the project to retrieve usage statistics for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Agent Run
>
> **Slug:** `BROWSERBASE_TOOL_GET_RUN`
>
> Retrieve a browser agent run's current status, result, and session details. Use List Run Messages separately to retrieve the run's messages.
>
> #### Input Parameters
>
> **runId** `string` *required*
>
> The run ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Secret
>
> **Slug:** `BROWSERBASE_TOOL_GET_SECRET`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The UUID of the project secret to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browser Session
>
> **Slug:** `BROWSERBASE_TOOL_GET_SESSION`
>
> Return status, connection details, and timestamps for a browser session.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Session Debug URLs
>
> **Slug:** `BROWSERBASE_TOOL_GET_SESSION_DEBUG_URLS`
>
> Return live debugger and WebSocket URLs for a running browser session.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the running session
>
> **expiresIn** `integer`
>
> Live-view URL lifetime in seconds, up to 21600
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Session Logs
>
> **Slug:** `BROWSERBASE_TOOL_GET_SESSION_LOGS`
>
> Return network request and response events captured during a browser session.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Session Replay
>
> **Slug:** `BROWSERBASE_TOOL_GET_SESSION_REPLAY`
>
> Return HLS replay metadata and page playlist paths for a recorded session.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the recorded session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Session Replay Page
>
> **Slug:** `BROWSERBASE_TOOL_GET_SESSION_REPLAY_PAGE`
>
> Return the HLS M3U8 playlist for one recorded replay page. Consume its short-lived signed media URLs promptly rather than storing them.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the recorded session
>
> **pageId** `string` *required*
>
> Recorded page ID from Get Session Replay
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Browserbase Webhook
>
> **Slug:** `BROWSERBASE_TOOL_GET_WEBHOOK`
>
> Retrieve a single webhook by ID, without its signing secret. The signing secret is only returned when creating a webhook or rotating it.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The webhook ID (UUID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Invoke Browserbase Function
>
> **Slug:** `BROWSERBASE_TOOL_INVOKE_FUNCTION`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the function to invoke.
>
> **params** `object`
>
> JSON object passed to the function.
>
> **sessionCreateParams** `object`
>
> Session configuration for this invocation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Agents
>
> **Slug:** `BROWSERBASE_TOOL_LIST_AGENTS`
>
> 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.
>
> #### Input Parameters
>
> **endAt** `string`
>
> Only return agents created on or before this inclusive RFC 3339 timestamp, e.g. 2026-01-20T00:00:00Z.
>
> **limit** `integer`
>
> Maximum number of results to return. Browserbase defaults to 20 when omitted.
>
> **cursor** `string`
>
> Pagination cursor from a previous response's nextCursor. Omit for the first page.
>
> **startAt** `string`
>
> Only return agents created on or after this inclusive RFC 3339 timestamp, e.g. 2026-01-19T00:00:00Z.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Certificates
>
> **Slug:** `BROWSERBASE_TOOL_LIST_CERTIFICATES`
>
> List Browserbase certificates with their IDs, timestamps, and project IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Downloads
>
> **Slug:** `BROWSERBASE_TOOL_LIST_DOWNLOADS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum results to return (1-100). Browserbase defaults to 20 when omitted.
>
> **offset** `integer`
>
> Number of results to skip. Browserbase defaults to 0 when omitted.
>
> **maxSize** `number`
>
> Maximum file size in bytes.
>
> **minSize** `number`
>
> Minimum file size in bytes.
>
> **filename** `string`
>
> Filter by exact filename match.
>
> **mimeType** `string`
>
> Filter by MIME type.
>
> **sessionId** `string` *required*
>
> Session ID whose downloads to list.
>
> **createdAfter** `string`
>
> Only return downloads created on or after this RFC 3339 timestamp.
>
> **createdBefore** `string`
>
> Only return downloads created on or before this RFC 3339 timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Function Builds
>
> **Slug:** `BROWSERBASE_TOOL_LIST_FUNCTION_BUILDS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum builds to return. Browserbase defaults to 20 when omitted.
>
> **offset** `integer`
>
> Builds to skip. Browserbase defaults to 0 when omitted.
>
> **status** `string`
>
> Filter builds by status (a free-form string).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Functions
>
> **Slug:** `BROWSERBASE_TOOL_LIST_FUNCTIONS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of functions to return. Browserbase defaults to 20 when omitted.
>
> **offset** `integer`
>
> Number of functions to skip. Browserbase defaults to 0 when omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Function Secrets
>
> **Slug:** `BROWSERBASE_TOOL_LIST_FUNCTION_SECRETS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the function whose attached secrets to list.
>
> **endAt** `string`
>
> Only return secrets created on or before this inclusive RFC 3339 timestamp, e.g. 2026-01-20T00:00:00Z.
>
> **limit** `integer`
>
> Maximum results to return (1-1000). Browserbase defaults to 20 when omitted.
>
> **cursor** `string`
>
> Pass nextCursor from the previous response to fetch the next page. Keep the same filters across pages. Omit for the first page.
>
> **startAt** `string`
>
> Only return secrets created on or after this inclusive RFC 3339 timestamp, e.g. 2026-01-19T00:00:00Z.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Function Versions
>
> **Slug:** `BROWSERBASE_TOOL_LIST_FUNCTION_VERSIONS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the function whose versions to list.
>
> **limit** `integer`
>
> Maximum versions to return (1-100). Browserbase defaults to 20 when omitted.
>
> **offset** `integer`
>
> Number of versions to skip. Browserbase defaults to 0 when omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Projects
>
> **Slug:** `BROWSERBASE_TOOL_LIST_PROJECTS`
>
> List projects with their default timeout and assigned concurrency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Recording Downloads
>
> **Slug:** `BROWSERBASE_TOOL_LIST_RECORDING_DOWNLOADS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of a completed session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Run Messages
>
> **Slug:** `BROWSERBASE_TOOL_LIST_RUN_MESSAGES`
>
> 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.
>
> #### Input Parameters
>
> **all** `boolean`
>
> Return every message after since, ignoring limit. Provider default is false.
>
> **limit** `integer`
>
> Maximum messages to return; omission uses the provider default of 20.
>
> **runId** `string` *required*
>
> The run ID (UUID).
>
> **since** `string`
>
> Last received message ID. Omit initially; pass nextSince to page or poll for newer messages.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Agent Runs
>
> **Slug:** `BROWSERBASE_TOOL_LIST_RUNS`
>
> 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.
>
> #### Input Parameters
>
> **endAt** `string`
>
> Inclusive creation-time upper bound in RFC 3339 format, e.g. 2026-01-20T00:00:00Z.
>
> **limit** `integer`
>
> Maximum results to return. Omission uses the provider default of 20.
>
> **cursor** `string`
>
> Pass nextCursor from the previous response to continue paging; omit for the first page.
>
> **status** `string ("PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "STOPPED" | "TIMED_OUT" | "PAUSED")`
>
> Filter by current run status; PAUSED awaits caller input.
>
> **agentId** `string`
>
> Only return runs referencing this agent ID.
>
> **startAt** `string`
>
> Inclusive creation-time lower bound in RFC 3339 format, e.g. 2026-01-19T00:00:00Z.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Secrets
>
> **Slug:** `BROWSERBASE_TOOL_LIST_SECRETS`
>
> 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.
>
> #### Input Parameters
>
> **endAt** `string`
>
> Only return secrets created on or before this timestamp (inclusive). RFC 3339, e.g. 2026-01-20T00:00:00Z.
>
> **limit** `integer`
>
> Maximum number of results to return. Browserbase defaults to 20.
>
> **cursor** `string`
>
> Pagination cursor. Pass nextCursor from the previous response to fetch the next page. Omit to start from the first page.
>
> **startAt** `string`
>
> Only return secrets created on or after this timestamp (inclusive). RFC 3339, e.g. 2026-01-19T00:00:00Z.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browser Sessions
>
> **Slug:** `BROWSERBASE_TOOL_LIST_SESSIONS`
>
> List browser sessions, optionally filtered by status or user metadata.
>
> #### Input Parameters
>
> **status** `string ("PENDING" | "RUNNING" | "ERROR" | "TIMED_OUT" | "COMPLETED")`
>
> Return only sessions with this lifecycle status
>
> **metadata\_query** `string`
>
> Filter by user metadata, for example user\_metadata\['env']:'prod'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Function Version Invocations
>
> **Slug:** `BROWSERBASE_TOOL_LIST_VERSION_INVOCATIONS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the function version whose invocations to list.
>
> **limit** `integer`
>
> Maximum invocations to return (1-100). Browserbase defaults to 20 when omitted.
>
> **offset** `integer`
>
> Number of invocations to skip. Browserbase defaults to 0 when omitted.
>
> **status** `string`
>
> Filter invocations by status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Browserbase Webhooks
>
> **Slug:** `BROWSERBASE_TOOL_LIST_WEBHOOKS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum results to return. Defaults to 20 on the server.
>
> **cursor** `string`
>
> Previous response's nextCursor. Omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Release Browser Session
>
> **Slug:** `BROWSERBASE_TOOL_RELEASE_SESSION`
>
> Irreversibly request release of a running browser session, ending it before its configured timeout to avoid further charges.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the running browser session to release
>
> **projectId** `string`
>
> Project linked to the session; inferred from the API key when omitted
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Request Recording Downloads
>
> **Slug:** `BROWSERBASE_TOOL_REQUEST_RECORDING_DOWNLOADS`
>
> Start asynchronous MP4 assembly for every recorded page of a completed session, then poll List Recording Downloads until every page is COMPLETED or FAILED.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of a completed session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resume Browserbase Agent Run
>
> **Slug:** `BROWSERBASE_TOOL_RESUME_RUN`
>
> 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.
>
> #### Input Parameters
>
> **task** `string`
>
> Reply to the agent's request for input in its trailing pause tool call.
>
> **runId** `string` *required*
>
> The run ID.
>
> **variables** `object`
>
> Named %variable% placeholders merged over the run's original variables. Values are not persisted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Browserbase Agent
>
> **Slug:** `BROWSERBASE_TOOL_RUN_AGENT`
>
> 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.
>
> #### Input Parameters
>
> **task** `string` *required*
>
> Natural language description of the task to accomplish.
>
> **agentId** `string`
>
> Custom agent ID. Uses its systemPrompt and resultSchema unless overridden.
>
> **pauseWhen** `string`
>
> When to pause awaiting application input. Enables the pause tool; resume via the resume endpoint.
>
> **variables** `object`
>
> Named %variable% placeholders with values and optional hints. Values are not persisted.
>
> **resultSchema** `object`
>
> JSON Schema for the result; overrides the referenced agent's default for this run.
>
> **browserSettings** `object`
>
> Browser configuration for the session. Omission uses runner defaults.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions get
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_GET`
>
> Deprecated compatibility action. Use GET\_SESSION.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser session to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions get debug
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_GET_DEBUG`
>
> Deprecated compatibility action. Use GET\_SESSION\_DEBUG\_URLS.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to retrieve debug URLs for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions get downloads
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_GET_DOWNLOADS`
>
> Deprecated compatibility action. Use DOWNLOAD\_SESSION\_ARTIFACTS.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to download artifacts from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions get logs
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_GET_LOGS`
>
> Deprecated compatibility action. Use GET\_SESSION\_LOGS.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to retrieve logs for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions list
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_LIST`
>
> Deprecated compatibility action. Use LIST\_SESSIONS.
>
> #### Input Parameters
>
> **q** `string`
>
> Query sessions by user metadata. Format: user\_metadata\['key']:'value' or for nested keys: user\_metadata\['key1']\['key2']:'value'.
>
> **status** `string ("RUNNING" | "ERROR" | "TIMED_OUT" | "COMPLETED")`
>
> Filter sessions by status. Available options: RUNNING, ERROR, TIMED\_OUT, COMPLETED.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sessions update
>
> **Slug:** `BROWSERBASE_TOOL_SESSIONS_UPDATE`
>
> Deprecated compatibility action. Use RELEASE\_SESSION.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser session to update
>
> **status** `string` *required*
>
> Set to REQUEST\_RELEASE to request that the session complete before its timeout
>
> **projectId** `string` *required*
>
> The Project ID linked to the session
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stop Browserbase Agent Run
>
> **Slug:** `BROWSERBASE_TOOL_STOP_RUN`
>
> 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.
>
> #### Input Parameters
>
> **runId** `string` *required*
>
> The run ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Browserbase Agent
>
> **Slug:** `BROWSERBASE_TOOL_UPDATE_AGENT`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Human-readable agent name used in the dashboard and API responses.
>
> **agentId** `string` *required*
>
> The ID of the agent to update.
>
> **resultSchema** `object`
>
> JSON Schema that agent runs aim to match in their result; may be overridden per run.
>
> **systemPrompt** `string`
>
> New system prompt steering every run that uses this agent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Browserbase Webhook
>
> **Slug:** `BROWSERBASE_TOOL_UPDATE_WEBHOOK`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The webhook ID (UUID).
>
> **endpoint** `string`
>
> Publicly reachable HTTPS URL that event deliveries are POSTed to. Omit to leave unchanged.
>
> **eventTypes** `array`
>
> Subscribed event types. Replaces the existing subscription; omit to leave unchanged. Values must be unique.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Browser Extension
>
> **Slug:** `BROWSERBASE_TOOL_UPLOAD_EXTENSION`
>
> 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.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> The browser extension file to upload (ZIP format).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Session File
>
> **Slug:** `BROWSERBASE_TOOL_UPLOAD_SESSION_FILE`
>
> Upload one file so browser interactions can select it in a file input field.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the session to upload the file to
>
> **file** `object` *required*
>
> File to upload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Session Files
>
> **Slug:** `BROWSERBASE_TOOL_UPLOAD_SESSION_FILES`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the browser session receiving the files
>
> **files** `array` *required*
>
> Files to upload for browser file-input interactions
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Web Search
>
> **Slug:** `BROWSERBASE_TOOL_WEB_SEARCH`
>
> Perform a web search and return structured results.
>
> #### Input Parameters
>
> **mode** `string ("fast" | "advanced" | "deep-lite" | "deep")`
>
> The search mode used by the underlying provider. See [https://docs.browserbase.com/platform/search/overview](https://docs.browserbase.com/platform/search/overview) for available modes and defaults. Requires provider: parallel supports fast/advanced; exa supports fast/deep-lite/deep.
>
> **query** `string` *required*
>
> The search query string
>
> **provider** `string ("parallel" | "exa")`
>
> Search provider to serve this request. Omit to use the default provider for your project (parallel).
>
> **numResults** `integer`
>
> Number of results to return (1-25). Defaults to 10 when omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
