Skip to main content

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

Returns the current public status and update time for a task. This endpoint is more lightweight than `GET /v3/bots/runs/{task_id}` and is recommended for polling.

Written by Maggie

GET /v3/bots/runs/{task_id}/status

Returns the current public status and update time for a task. This endpoint is more lightweight than `GET /v3/bots/runs/{task_id}` and is recommended for polling.

Authentication

HTTPBearer

Parameters

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

Responses

200 — Run status returned.

{  "task_id": "string",  "status": "created",  "updated_at": "2026-01-01T00:00:00Z"}

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?