/agent/run/*
GET/agent/run/*
Poll an agent run: its status, the latest turn result and streamed step rationales, and the full turn transcript.
Request
Query Parameters
Possible values: [datacenter, residential]
Possible values: [0, 1, false, true]
Possible values: [0, 1, false, true]
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
Schema
- Fields
- Example (auto)
- Array [
- Array [
- ]
- ]
- Array [
- Array [
- Array [
- ]
- ]
- ]
Run ID.
Run status.
Possible values: [capped, failed, needs_human, pending, running, stopped, succeeded, timed_out]
humanRequest object
Present while the run waits for a human, and with its outcome afterwards.
Why the agent needs a human.
Possible values: [login_wall, step_up_mfa]
What the human should do.
Live URL where the human completes the step.
ISO 8601 timestamp when the handoff expires.
How the handoff ended.
Possible values: [closed, expired, resumed, stopped, userFailed]
The latest turn's result, shaped by responseSchema when one was given.
The latest turn's error message, or null.
Step rationales for the latest turn.
actions object[]required
Every tool call the latest turn made, appended as each finishes; seq gives call order.
1-based tool-call order within the turn, continuing across human handoffs.
ISO 8601 time the tool call started.
Milliseconds until the result, or null when incomplete.
Tool the agent called.
commands object[]required
Browser commands in this call.
Browser command name, or unknown when the agent sent one that does not exist.
Target selector with attribute values replaced by REDACTED; omitted when it cannot be shown safely.
Navigation URL with credentials and query values redacted and fragment removed.
Length of typed text; the text itself is never returned.
Outcome.
Possible values: [error, incomplete, ok]
Bounded MCP error category, when available; never the error message.
Requested page HTML, or null.
Requested page Markdown, or null.
Requested links extracted from the page, or null.
Requested viewport PNG encoded as base64, or null.
formatErrors object
Present only for missing requested captures; maps format names to reason codes.
Possible values: [blocked_saved_credentials, capture_failed, not_captured, session_unavailable, too_large]
Possible values: [blocked_saved_credentials, capture_failed, not_captured, session_unavailable, too_large]
Possible values: [blocked_saved_credentials, capture_failed, not_captured, session_unavailable, too_large]
Possible values: [blocked_saved_credentials, capture_failed, not_captured, session_unavailable, too_large]
Present only when replay: true was requested and the run couldn't provision a recordable session.
session_unavailablePresent when replay: true was requested and the recording was saved. Open it at /account/session-replay/player?id=<replayId>.
turns object[]required
The turn transcript.
Turn ID.
The task submitted for this turn.
Turn status.
Possible values: [capped, failed, needs_human, pending, running, stopped, succeeded, timed_out]
The turn's result, same shape as the top-level data.
Step rationales for this turn.
actions object[]required
Every tool call this turn made, appended as each finishes; seq gives call order.
1-based tool-call order within the turn, continuing across human handoffs.
ISO 8601 time the tool call started.
Milliseconds until the result, or null when incomplete.
Tool the agent called.
commands object[]required
Browser commands in this call.
Browser command name, or unknown when the agent sent one that does not exist.
Target selector with attribute values replaced by REDACTED; omitted when it cannot be shown safely.
Navigation URL with credentials and query values redacted and fragment removed.
Length of typed text; the text itself is never returned.
Outcome.
Possible values: [error, incomplete, ok]
Bounded MCP error category, when available; never the error message.
Units derived from the model tokens this turn consumed. Informational only: runs are billed for browser time.
Present only when replay: true was requested and the run couldn't provision a recordable session for this turn.
session_unavailablePresent when replay: true was requested and the recording was saved. Open it at /account/session-replay/player?id=<replayId>.
ISO 8601 timestamp when the run was created.
ISO 8601 timestamp when the run finished, or null while active.
ISO 8601 timestamp when the run's results expire, or null.
{
"id": "string",
"status": "capped",
"humanRequest": {
"reason": "login_wall",
"instructions": "string",
"liveURL": "string",
"expiresAt": "string",
"outcome": "closed"
},
"error": "string",
"steps": [
"string"
],
"actions": [
{
"seq": 0,
"startedAt": "string",
"durationMs": 0,
"tool": "string",
"commands": [
{
"method": "string",
"selector": "string",
"url": "string",
"textLength": 0
}
],
"status": "error",
"errorCode": "string"
}
],
"html": "string",
"markdown": "string",
"links": [
"string"
],
"screenshot": "string",
"formatErrors": {
"html": "blocked_saved_credentials",
"markdown": "blocked_saved_credentials",
"links": "blocked_saved_credentials",
"screenshot": "blocked_saved_credentials"
},
"replayError": "session_unavailable",
"replayId": "string",
"turns": [
{
"turnId": "string",
"query": "string",
"status": "capped",
"steps": [
"string"
],
"actions": [
{
"seq": 0,
"startedAt": "string",
"durationMs": 0,
"tool": "string",
"commands": [
{
"method": "string",
"selector": "string",
"url": "string",
"textLength": 0
}
],
"status": "error",
"errorCode": "string"
}
],
"units": 0,
"replayError": "session_unavailable",
"replayId": "string"
}
],
"created_at": "string",
"completed_at": "string",
"expires_at": "string"
}
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.