Skip to main content
Browser Use logo

Overview

Add Browser Use to any ModuleX agent or workflow. AI-powered cloud browser automation via the Browser Use REST API (api.browser-use.com/api/v3). Create agent sessions to perform web tasks, manage standalone browser sessions via CDP, and organize persistent profiles and workspaces.
Categories: AI & Machine Learning · Automation · AI · Developer Tools & Infrastructure · Auth: API Key · Actions: 25

Authentication

API Key Authentication

Authenticate using your Browser Use API key
1

Step 1

2

Step 2

Navigate to your project settings or API Keys section
3

Step 3

Create a new API key or copy your existing one
4

Step 4

Paste the API key below

Required Credentials

Available Actions

Parameters

string
Natural-language instruction for the agent
string
Browser Use agent model. Allowed values: claude-sonnet-4.6, claude-opus-4.6, gemini-3-flash, bu-mini, bu-max, bu-ultra (Default: claude-sonnet-4.6)
string
ID of an existing session to dispatch a follow-up task to
boolean
If true, the session stays idle after the task completes so it can accept follow-up tasks (Default: false)
string
Maximum total session cost in USD. Example: 1.50
string
ID of a Browser Use profile to use
string
ID of a Browser Use workspace to attach
string
Lowercase proxy country code for browser traffic. Examples: us, de, jp. Enter none to disable proxy (Default: us)
object
Optional JSON Schema for structured output
boolean
If true, the agent can create scheduled tasks tied to your project (Default: false)
object
Key-value pairs available to the agent through secure placeholders. Keys are visible to the model; values are hidden
boolean
If true, Browser Use records the browser session and returns recording URLs after completion (Default: false)
boolean
If true, enables built-in Browser Use agent skills such as file management (Default: true)
boolean
If true, provisions a temporary email inbox for the session (Default: true)
string
Controls deterministic script caching. Allowed values: auto, enabled, disabled (Default: auto)
boolean
If true, uses your configured LLM provider key instead of Browser Use managed keys (Default: false)
boolean
When script caching is active, validates cached script output and reruns the full agent if the result looks incorrect (Default: true)

Response

Parameters

string
required
ID of the Browser Use agent session

Response

Parameters

integer
Page number to fetch. The first page is 1 (Default: 1)
integer
Number of records to return per page. Maximum: 100 (Default: 20)

Response

Parameters

string
required
ID of the Browser Use agent session to delete

Response

Parameters

string
required
ID of the Browser Use agent session
string
Use task to stop only the current task and keep the session alive, or session to destroy the sandbox entirely. Allowed values: task, session (Default: session)

Response

Parameters

string
required
ID of the Browser Use agent session
string
Return messages after this message ID cursor
string
Return messages before this message ID cursor
integer
Maximum number of messages to return. Maximum: 100 (Default: 10)

Response

Parameters

string
ID of a Browser Use profile
string
Lowercase proxy country code for browser traffic. Examples: us, de, jp. Enter none to disable proxy (Default: us)
integer
Session timeout in minutes. Supported range: 1 to 240 (Default: 60)
integer
Custom browser screen width in pixels. Supported range: 320 to 6144
integer
Custom browser screen height in pixels. Supported range: 320 to 3456
boolean
Whether to allow browser resizing during the session (Default: false)
object
Custom proxy object with host, port, username, and password fields. Requires an active subscription
boolean
If true, records the browser session (Default: false)

Response

Parameters

string
required
ID of the Browser Use browser session

Response

Parameters

integer
Number of records to return per page. Maximum: 100 (Default: 20)
integer
Page number to fetch. The first page is 1 (Default: 1)
string
Filter browser sessions by status. Allowed values: active, stopped

Response

Parameters

string
required
ID of the Browser Use browser session
string
required
Action to perform on the browser session. Currently supported value: stop (Default: stop)

Response

Parameters

string
Optional profile name. Maximum length: 100 characters
string
Optional internal user identifier from your system. Maximum length: 255 characters

Response

Parameters

string
required
ID of the Browser Use profile

Response

Parameters

integer
Number of records to return per page. Maximum: 100 (Default: 20)
integer
Page number to fetch. The first page is 1 (Default: 1)
string
Search query for profile name or user ID. Maximum length: 200 characters

Response

Parameters

string
required
ID of the Browser Use profile to delete

Response

Parameters

string
required
ID of the Browser Use profile
string
Updated profile name. Maximum length: 100 characters
string
Updated internal user identifier. Maximum length: 255 characters

Response

Parameters

string
Optional workspace name. Maximum length: 100 characters

Response

Parameters

string
required
ID of the Browser Use workspace

Response

Parameters

integer
Number of records to return per page. Maximum: 100 (Default: 20)
integer
Page number to fetch. The first page is 1 (Default: 1)

Response

Parameters

string
required
ID of the Browser Use workspace to delete

Response

Parameters

string
required
ID of the Browser Use workspace
string
required
Updated workspace name. Maximum length: 100 characters

Response

Parameters

string
required
ID of the Browser Use workspace

Response

Parameters

string
required
ID of the Browser Use workspace
string
Optional directory prefix to list. Example: reports/
integer
Maximum number of files to return. Maximum: 100 (Default: 50)
string
Pagination cursor from a previous response
boolean
If true, include presigned download URLs for files (Default: false)
boolean
If true, list only immediate files and folders at the prefix (Default: false)

Response

Parameters

string
required
ID of the Browser Use workspace
string
required
Relative workspace file path to delete. Example: reports/data.csv

Response

Parameters

string
required
ID of the Browser Use workspace
string
Optional directory prefix to upload into. Example: uploads/
string
required
JSON array of file metadata objects. Each object has name (required), contentType (optional), and size (optional integer). 1 to 10 files per request

Response

Response

Limits & Quotas

  • No publicly documented request rate limits at the time of writing.
  • Agent sessions are billed by runtime and model usage; max_cost_usd parameter available to cap spend per session.
  • Browser sessions are billed by runtime and can run up to 4 hours.
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

HeyGen

Algolia

Amazon Alexa