Skip to main content
GET
List messages
Your messages have role: "user" and the agent’s have role: "assistant". Each agent reply is a single message whose content[] holds the whole reply: text, tool calls, and results. A reply still in progress has status: "streaming" with the content so far. limit (default 200, max 500) bounds the underlying events read, not the messages returned, so expect fewer messages than limit. The first page is the most recent stretch of the conversation.

Authorizations

Authorization
string
header
required

Requires an API key. See the Authentication guide.

Path Parameters

task_id
string
required

Query Parameters

limit
integer
default:200
Required range: 1 <= x <= 500
before_id
string | null
after_id
string | null

Response

200 - application/json

Page of messages, oldest first.

data
Message · object[]
required
type
string
default:list
Allowed value: "list"
has_more
boolean
default:false
first_id
string | null
last_id
string | null