Run browser task
browser_taskExecute a browser automation task in a real Chrome browser running in a WebRun cloud environment (docs.webrun.ai). Creates a session, runs the task, and auto-terminates. Best for simple one-off tasks that no saved workflow covers. May navigate, fill forms, and submit data on third-party websites as the task requires. Do NOT use this to run or test a saved workflow — use trigger_workflow instead: only a workflow run carries the workflow's own rules, tracking and memory, so a session run will behave differently. If the user says "run it", "run it once", "test it" or "try it" about a workflow, that means trigger_workflow, not this tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "browser_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | Optional file IDs to attach: ids returned by POST /files/upload, or any file already in one of the user's environment catalogs (GET /environments/:id/files). Max 5 files. | |
| model | No | Optional model name or profile key (from global config). Falls back to the configured default. | |
| proxy | No | Proxy configuration. WebRun-managed: { source: "WebRun", country: "GB" }. Custom: { source: "custom", type: "http"|"socks", host, port, username?, password? }. Omit for no proxy. Social/messaging automation (WhatsApp, Telegram, Instagram, Facebook, X, LinkedIn, TikTok): prefer country = the country the user is in right now — recommend it and confirm the country with them first; a mismatch is the usual cause of refused logins and sessions that log out repeatedly. | |
| debugC | No | Enable debug mode on the instance (default: false) | |
| prompt | Yes | Task description in natural language | |
| secrets | No | Domain-matched secrets [{match, fields}] passed to instance (not stored) | |
| webhook | No | Webhook configuration for task completion notification | |
| policyId | No | Policy ID to apply automation guardrails (domain restrictions, capability controls, LLM role). Optional. | |
| timezone | No | IANA timezone name for the session, e.g. "America/New_York", "Europe/London", "Asia/Tokyo". Date/time-sensitive instructions (e.g. "tomorrow morning", "today", "in 2 hours") are interpreted in this timezone. When omitted, follows the WebRun proxy country if one is set (e.g. country "de" → Europe/Berlin); otherwise the browser default. | |
| outputType | No | Response format (default: text) | |
| maxDuration | No | Max duration in minutes (default: 20, max: 60) | |
| startingUrl | No | Optional starting URL | |
| outputSchema | No | JSON Schema for structured output (required if outputType is structured_json) | |
| environmentId | No | Environment ID for persistent profile session. Use list_environments to find available IDs. Without this, a disposable instance is used. | |
| reach_out_mode | No | Controls proactive chat-platform messages (Telegram/WhatsApp/Slack/Discord/Teams) to bot users on the same environment. Default: "off" — no messages are sent unless this is set explicitly. "guardrail_only" forwards guardrail prompts (CAPTCHA/2FA/verification) to chat when the API caller is offline. "full" also forwards the task result on completion. Each bot user additionally filters by their own reachOutMode preference. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Task output payload (instance-authored shape) | |
| type | No | Result type, e.g. 'task_completed', 'task_failed', 'guardrail_trigger' | |
| error | No | ||
| status | No | Present on guardrail results: 'awaiting_input' | |
| taskId | No | ||
| message | No | ||
| pending | No | True when the task is still running — poll get_task_status | |
| success | No | ||
| sessionId | No | ||
| environment | No | ||
| liveViewURL | No | Page for watching the run live, present while it is still running or awaiting input. The only URL here that is safe to show a user or open in a browser. |