Skip to main content
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:
Recommended poll interval: 2 seconds. Lower than that wastes requests; higher than that adds user-visible latency.

Errors