Skip to main content
get/messages
Request example
Response
get/messages

Authorization

Authorizationstringheaderrequired#

Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).

Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).

Query parameters

conversation_idstringrequired#
ID of the conversation to read. Get conversation IDs from List Conversations.
userstring#
End-user identifier, defined by your app and unique within it. See End User Identity.
first_idstring#
Pagination cursor: the id of the first message on the current page. Pass it to fetch the previous (older) page; omit to fetch the latest messages.
limitinteger#
Number of chat history messages to return per request.

Default: 20

Range: 1–100

Responses

application/json
Successfully retrieved conversation history.
dataobject[]#
List of messages.
has_moreboolean#
Whether there are more messages.
limitinteger#
Number of items per page.