Skip to main content
GET
/
v1
/
chat
/
tasks
/
{task_id}
Get Chat Task
curl --request GET \
  --url https://api.example.com/v1/chat/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": 123,
  "agent_id": 123,
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "input": "<string>",
  "output": "<string>",
  "error": "<string>",
  "completed_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
task_id
integer
required

Response

Successful Response

GET /v1/chat/tasks/{task_id} response.

Returns a snapshot of the task's current state from the tasks row. input / output / error reflect the latest turn only -- full transcript history is queryable via the /steps endpoint's message type steps.

​
task_id
integer
required
​
agent_id
integer
required
​
status
string
required

One of: pending / running / paused / completed / failed.

​
created_at
string<date-time>
required
​
input
string | null

Latest-turn user input. Null if no message yet recorded.

​
output
string | null

Latest-turn assistant output. Populated when status reaches 'completed'; null while running or pending.

​
error
string | null

Last failure reason when status='failed'.

​
completed_at
string<date-time> | null

UTC timestamp when the task reached a terminal state (completed or failed). Null while still running.