Send task to session
send_taskSend a new task to an existing browser session (from create_session). The real Chrome browser may navigate, fill forms, and submit data on third-party websites as the task requires.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | Optional file IDs to attach (from /files/upload). Max 5 files. | |
| prompt | Yes | Task description | |
| secrets | No | Domain-matched secrets [{match, fields}] (not stored) | |
| webhook | No | Webhook configuration | |
| sessionId | Yes | Session ID from create_session | |
| outputType | No | Response format | |
| maxDuration | No | Max duration for this task in minutes (3-60). Defaults to the value the session was created with. | |
| startingUrl | No | URL to navigate to before starting this task (optional) | |
| outputSchema | No | JSON Schema for structured output (required if outputType is structured_json) | |
| maxInputTokens | No | Max input tokens for this task (100-3000000). Defaults to the value the session was created with. | |
| maxOutputTokens | No | Max output tokens for this task (100-1000000). Defaults to the value the session was created with. | |
| terminateOnCompletion | No | Auto-terminate after task (default: false) |
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. |