Skip to main content
GET
Read a conversation

Authorizations

Authorization
string
header
required

Agent token (alt_…) or OAuth access token; bound to one agent

Path Parameters

threadId
string
required

Thread id (thr_…)

Query Parameters

cursor
string

Opaque cursor from a previous page's next_cursor; returns older messages

limit
integer

Messages per page, 1–50 (default 50); a page is also bounded by total body size

Required range: 1 <= x <= 50

Response

Messages, newest page first

messages
object[]
required
next_cursor
string | null
required

Pass as cursor for the next page; null on the last page