Raw schema
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "Task description in natural language"
},
"startingUrl": {
"type": "string",
"description": "Optional starting URL"
},
"maxDuration": {
"type": "number",
"description": "Max duration in minutes (default: 5)"
},
"outputType": {
"type": "string",
"enum": [
"text",
"structured_json",
"structured_csv"
],
"description": "Response format (default: text)"
},
"outputSchema": {
"type": "object",
"description": "JSON Schema for structured output (required if outputType is structured_json)"
},
"webhook": {
"type": "object",
"description": "Webhook configuration for task completion notification",
"properties": {
"name": {
"type": "string",
"description": "Webhook identifier"
},
"url": {
"type": "string",
"description": "HTTPS URL to receive webhook"
},
"auth": {
"type": "string",
"description": "Authorization header value"
},
"submittedData": {
"type": "string",
"enum": [
"full_response",
"structured_output",
"just_ping"
],
"description": "Payload type"
}
}
},
"secrets": {
"type": "array",
"description": "Domain-matched secrets [{match, fields}] passed to instance (not stored)",
"items": {
"type": "object"
}
},
"environmentId": {
"type": "string",
"description": "Environment ID for persistent profile session. Use list_environments to find available IDs. Without this, a disposable instance is used."
},
"policyId": {
"type": "string",
"description": "Policy ID to apply automation guardrails (domain restrictions, capability controls, LLM role). Optional."
},
"debugC": {
"type": "boolean",
"description": "Enable debug mode on the instance (default: false)"
},
"files": {
"type": "array",
"description": "Optional file IDs to attach (from /files/upload). Max 5 files.",
"items": {
"type": "string"
}
},
"proxy": {
"type": "object",
"description": "Proxy configuration. WebRun-managed: { source: \"WebRun\", country: \"GB\" }. Custom: { source: \"custom\", type: \"http\"|\"socks\", host, port, username?, password? }. Omit for no proxy.",
"properties": {
"source": {
"type": "string",
"enum": [
"WebRun",
"custom"
],
"description": "Proxy provider"
},
"country": {
"type": "string",
"description": "ISO country code for WebRun proxy (e.g. \"GB\", \"US\") or \"random\" for a random country with good connectivity"
},
"level": {
"type": "string",
"enum": [
"system",
"chrome"
],
"description": "Proxy level. \"chrome\" (default) applies proxy via browser extension (instant, no swap). \"system\" launches Chrome with --proxy-server flag (requires instance swap)."
},
"type": {
"type": "string",
"enum": [
"http",
"socks"
],
"description": "Custom proxy type"
},
"host": {
"type": "string",
"description": "Custom proxy host"
},
"port": {
"type": "number",
"description": "Custom proxy port"
},
"username": {
"type": "string",
"description": "Custom proxy username (optional)"
},
"password": {
"type": "string",
"description": "Custom proxy password (optional)"
}
}
},
"reach_out_mode": {
"type": "string",
"enum": [
"off",
"guardrail_only",
"full"
],
"description": "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."
},
"model": {
"type": "string",
"description": "Optional model name or profile key (from global config). Falls back to the configured default."
},
"timezone": {
"type": "string",
"description": "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. Defaults to \"UTC\" when omitted."
}
},
"required": [
"prompt"
]
}