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

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

userstring#
End-user identifier, defined by your app and unique within it. See End User Identity.
last_idstring#
Pagination cursor: the id of the last conversation on the current page. Omit to fetch the first page.
limitinteger#
Number of records to return.

Default: 20

Range: 1–100

sort_byenum<string>#
Field to sort by. Prefix with - for descending order.

Default: "-updated_at"

Options:created_at-created_atupdated_at-updated_at

Responses

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