Get task
Tasks
Get task
Fetch a single task record. Poll this to track pending tasks to completion.
GET
Get task
Path parameters
string
required
The task identifier returned by
POST /v1/tasks.Response — 200 OK
string
Task identifier.
string
The session this task belongs to.
string
The end-user the task ran for.
string
The prompt as originally submitted.
string
"pending" | "running" | "completed" | "failed" | "cancelled".string | object
The final answer. String for most tasks; JSON object for tasks that return structured data or when
schema was provided.object
Only present when the request included
schema. The object conforming to that schema.string
Only present when the request had
include_html_dump: true. Raw HTML of the final page.number
Number of agent steps executed.
number
Wall-clock duration of the task in milliseconds.
string[]
Domains the agent navigated to, deduplicated in order.
StepSummary[]
Per-step trace:
{ n, type, msg, success }.string
Populated only when
status == "failed".string (ISO 8601)
When the task was submitted.
string (ISO 8601)
Last status change.
Additional internal fields may be present on the response for observability and may change without notice. Rely only on the fields documented above.
Example
Polling pattern
Both SDKs’tasks.run(...) wrap submit + poll in one call. If you’re polling yourself:
