Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

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_id
string
required

ID of the conversation to read. Get conversation IDs from List Conversations.

user
string

End-user identifier, defined by your app and unique within it. See End User Identity.

first_id
string

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.

limit
integer
default:20

Number of chat history messages to return per request.

Required range: 1 <= x <= 100

Response

Successfully retrieved conversation history.

limit
integer

Number of items per page.

has_more
boolean

Whether there are more messages.

data
object[]

List of messages.