Skip to main content
GET
List messages

Authorizations

Authorization
string
header
required

An API key (onx_sk_…) created in OnlyX under Settings → API & MCP, or an OAuth access token (onx_at_…) issued to a connected app. Send it as Authorization: Bearer <credential>. API keys may also be sent as X-API-Key: <key>.

Path Parameters

conversationId
string
required

The conversation id (cnv_…), from GET /v1/conversations.

Maximum string length: 40

Query Parameters

before
string | null

A message id: return only messages older than it.

Maximum string length: 40
limit
integer
default:25

Page size, 1-100. Default 25.

Required range: 1 <= x <= 100

Response

A page of messages, oldest to newest.

{data, hasMore}: messages oldest to newest; page back with before.

data
Message · object[]
required

Messages, oldest to newest.

hasMore
boolean
required

true when there are older messages. Fetch them with before set to the first (oldest) id on this page.