Sign in
Conversations

List Conversation Messages

Available for: Chatflow, Agent, Chatbot, Legacy Agent apps.

Returns a conversation's message history, newest first. Pass first_id to page backward into older messages.

get/messages

Query parameters

conversation_idstring required

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.

Response

Successfully retrieved conversation history.

limitinteger

Number of items per page.

has_moreboolean

Whether there are more messages.

Changes

Changed in 1 of the 10 revisions of this API.6

  • 1647da4777896See the full diff
    • ○

      added the optional property data/items/answer_tokens to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/currency to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/message_tokens to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/provider_response_latency to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/total_price to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/total_tokens to the response with the 200 status

      response-optional-property-added