Skip to main content

Retrieve a task — GET /v3/bots/runs/{task_id}

Returns comprehensive information about a task, including its current `status`, accepted `input`, output, failure details, files, live browser information, and Bot step summaries when available. Fields that do not apply to the run type or state are omitt

Written by Maggie

GET /v3/bots/runs/{task_id}

Returns comprehensive information about a task, including its current `status`, accepted `input`, output, failure details, files, live browser information, and Bot step summaries when available.Fields that do not apply to the run type or state are omitted. Official template runs do not expose template source fields or the internally copied Bot ID. If you only need the current status, use `GET /v3/bots/runs/{task_id}/status`.

Authentication

HTTPBearer

Parameters

  • task_id (path, string, required) — Task ID

Responses

200 — Run returned.

{  "task_id": "string",  "log_detail_url": "string",  "bot_id": "string",  "bot_type": "workflow",  "bot_name": "string",  "status": "created",  "created_at": "2026-01-01T00:00:00Z",  "finished_at": "2026-01-01T00:00:00Z",  "input": {},  "task_failure_info": {    "code": 0,    "message": "string"  },  "output": "string",  "output_files": {},  "download_files": [    {      "guid": "string",      "file_name": "string",      "file_size": 0,      "status": "string",      "progress": 0,      "download_url": "string",      "download_start_time": 0,      "download_completed_time": 0,      "expires_at": 0,      "error_message": "string",      "create_time": 0    }  ],  "files_expires_at": 0,  "steps": [    {      "id": "string",      "step": 0,      "evaluation_previous_goal": "string",      "step_goal": "string",      "screenshots_url": "string",      "status": "running"    }  ],  "live_url_info": {    "live_url": "string",    "width": 0,    "height": 0  },  "credit": 0}

400 — Run not found. Returns error code 10112.

{  "code": 123,  "msg": "Invalid task_id",  "data": null,  "ts": 1786634400000,  "time": "2026-08-13 18:00:00",  "traceId": "a1b2c3d4e5f6"}

500 — Internal Server Error

{  "code": 123,  "msg": "Invalid task_id",  "data": null,  "ts": 1786634400000,  "time": "2026-08-13 18:00:00",  "traceId": "a1b2c3d4e5f6"}

Did this answer your question?