Skip to main content
GET
Get session messages
Messages are returned in reverse chronological order (newest first) by default. Use the cursor values for efficient pagination through large conversation histories.

Path Parameters

string
required
The unique identifier of the session

Query Parameters

number
Number of messages to retrieve (1-100). Default: 50
number
Timestamp to get messages before (for older messages)
number
Timestamp to get messages after (for newer messages)

Response

array
Array of messages in the conversation
boolean
Whether more messages are available
object
Pagination cursors for fetching additional messages

Example Usage

Path Parameters

sessionId
string
required

ID of the session

Query Parameters

limit
integer
default:50

Maximum number of messages to return

Required range: 1 <= x <= 100
before
string<date-time>

Get messages before this timestamp

after
string<date-time>

Get messages after this timestamp

Response

Messages retrieved successfully

messages
object[]
hasMore
boolean

Whether there are more messages available

cursors
object

Pagination cursors for fetching additional messages