Get Session Messages

Retrieve messages from a conversation session with cursor-based pagination

Messages are returned in reverse chronological order (newest first) by default. Use the cursor values for efficient pagination through large conversation histories.

Path Parameters

sessionId · string · required

The unique identifier of the session

Query Parameters

limit · number

Number of messages to retrieve (1-100). Default: 50

before · number

Timestamp to get messages before (for older messages)

after · number

Timestamp to get messages after (for newer messages)

Response

messages · array

Array of messages in the conversation

Show Message Properties

id · string

Unique message identifier

content · string

Message content

authorId · string

UUID of the message author

isAgent · boolean

Whether the message is from the agent

createdAt · string

ISO timestamp of message creation

metadata · object

Message metadata including agent thoughts and actions

hasMore · boolean

Whether more messages are available

cursors · object

Pagination cursors for fetching additional messages

Show Cursor Properties

before · number

Use this timestamp to get older messages

after · number

Use this timestamp to get newer messages

Example Usage

Initial Fetch

// Get the most recent 20 messages
const response = await fetch(
  '/api/messaging/sessions/abc-123/messages?limit=20'
);

const { messages, hasMore, cursors } = await response.json();