Skip to main content
Server path: /browse-ai | Type: Application | PCID required: Yes

Tools

ToolDescription
browse_ai_create_bulk_runCreate a bulk run
browse_ai_create_robot_webhookCreate a robot webhook
browse_ai_delete_robot_webhookDelete a robot webhook
browse_ai_get_robotGet robot details
browse_ai_get_robot_taskGet task details
browse_ai_get_statusGet system status
browse_ai_list_all_tasksList all tasks across robots
browse_ai_list_robot_tasksList tasks for a robot
browse_ai_list_robot_webhooksList robot webhooks
browse_ai_list_robotsList robots
browse_ai_run_robot_taskRun a robot task
browse_ai_update_robot_cookiesUpdate robot cookies

browse_ai_create_bulk_run

Create a bulk run Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
inputParametersobject[]YesList of input-parameter objects, one per task to run. Each object’s keys must match the robot’s expected inputs.
titlestringNoA human-readable title for this bulk run.

browse_ai_create_robot_webhook

Create a robot webhook Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
eventTypestringNoEvent type that triggers the webhook (e.g. ‘task.finished’).
hookUrlstringYesPublic HTTPS URL that Browse AI will POST task results to.

browse_ai_delete_robot_webhook

Delete a robot webhook Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
webhookIdstringYesThe unique identifier of the webhook to delete.

browse_ai_get_robot

Get robot details Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.

browse_ai_get_robot_task

Get task details Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
taskIdstringYesThe unique identifier of the task.

browse_ai_get_status

Get system status

browse_ai_list_all_tasks

List all tasks across robots Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage number for pagination (1-indexed).
sortstringNoSort order. Use a field name with optional ’-’ prefix for descending (e.g. ‘-createdAt’).
statusstringNoFilter tasks by status.

browse_ai_list_robot_tasks

List tasks for a robot Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
pageintegerNoPage number for pagination (1-indexed).
sortstringNoSort order. Use a field name with optional ’-’ prefix for descending (e.g. ‘-createdAt’).
statusstringNoFilter tasks by status.
fromDateintegerNoFilter tasks created at or after this Unix timestamp (milliseconds).
toDateintegerNoFilter tasks created at or before this Unix timestamp (milliseconds).

browse_ai_list_robot_webhooks

List robot webhooks Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.

browse_ai_list_robots

List robots Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage number for pagination (1-indexed).

browse_ai_run_robot_task

Run a robot task Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot to run.
inputParametersobjectYesRobot-specific input parameters. Use getRobot to discover the required fields. Common keys include ‘originUrl’. Additional properties are allowed.
recordVideobooleanNoWhether to record a video of the run.

browse_ai_update_robot_cookies

Update robot cookies Parameters:
ParameterTypeRequiredDefaultDescription
robotIdstringYesThe unique identifier of the robot.
cookiesobject[]YesList of cookie objects to attach to this robot.