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.
Authentication
API Key Authentication
Authenticate using your Browser Use API keyStep 1
Step 2
Step 3
Step 4
Required Credentials
Available Actions
create_session — Create an agent session, dispatch a task, or dispatch a follow-up task to an existing idle session
create_session — Create an agent session, dispatch a task, or dispatch a follow-up task to an existing idle session
Parameters
claude-sonnet-4.6)false)us)false)false)true)true)auto)false)true)Response
get_session — Get the current state, output, live URL, screenshot URL, and cost details for an agent session
get_session — Get the current state, output, live URL, screenshot URL, and cost details for an agent session
list_sessions — List Browser Use agent sessions for the authenticated project
list_sessions — List Browser Use agent sessions for the authenticated project
delete_session — Delete an agent session
delete_session — Delete an agent session
stop_session — Stop the current task or stop the entire Browser Use agent session
stop_session — Stop the current task or stop the entire Browser Use agent session
list_session_messages — List messages from a Browser Use agent session, including reasoning, tool calls, browser actions, screenshots, and results
list_session_messages — List messages from a Browser Use agent session, including reasoning, tool calls, browser actions, screenshots, and results
create_browser_session — Create a standalone browser session for direct browser control through CDP
create_browser_session — Create a standalone browser session for direct browser control through CDP
Parameters
us)60)false)false)Response
get_browser_session — Get details for a standalone browser session, including live URL, CDP URL, status, timeout, and cost fields
get_browser_session — Get details for a standalone browser session, including live URL, CDP URL, status, timeout, and cost fields
list_browser_sessions — List standalone browser sessions for direct browser control via CDP
list_browser_sessions — List standalone browser sessions for direct browser control via CDP
update_browser_session — Update a standalone browser session. Currently supports the stop action
update_browser_session — Update a standalone browser session. Currently supports the stop action
get_profile — Get a Browser Use profile by ID
get_profile — Get a Browser Use profile by ID
list_profiles — List Browser Use profiles, optionally searching by profile name or user ID
list_profiles — List Browser Use profiles, optionally searching by profile name or user ID
delete_profile — Delete a Browser Use profile and its persisted browser state
delete_profile — Delete a Browser Use profile and its persisted browser state
update_profile — Update a Browser Use profile name or user ID
update_profile — Update a Browser Use profile name or user ID
get_workspace — Get a Browser Use workspace by ID
get_workspace — Get a Browser Use workspace by ID
delete_workspace — Delete a Browser Use workspace and its stored files. This cannot be undone
delete_workspace — Delete a Browser Use workspace and its stored files. This cannot be undone
update_workspace — Update a Browser Use workspace name
update_workspace — Update a Browser Use workspace name
get_workspace_size — Get storage usage for a Browser Use workspace
get_workspace_size — Get storage usage for a Browser Use workspace
list_workspace_files — List files and folders in a Browser Use workspace, optionally returning presigned download URLs
list_workspace_files — List files and folders in a Browser Use workspace, optionally returning presigned download URLs
Parameters
50)false)false)Response
delete_workspace_file — Delete a file from a Browser Use workspace
delete_workspace_file — Delete a file from a Browser Use workspace
upload_workspace_files — Create presigned upload URLs for workspace files
upload_workspace_files — Create presigned upload URLs for workspace files
get_account_billing — Get account billing details for the authenticated project
get_account_billing — Get account billing details for the authenticated project
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_usdparameter 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+errorrather than raising.