Skip to main content
GET
/
messages
Error
A valid request URL is required to generate request examples
{
  "limit": 20,
  "has_more": false,
  "data": [
    {
      "id": "9da23599-e713-473b-982c-4328d4f5c78a",
      "conversation_id": "45701982-8118-4bc5-8e9b-64562b4555f2",
      "parent_message_id": null,
      "inputs": {
        "city": "San Francisco"
      },
      "query": "What are the specs of the iPhone 13 Pro Max?",
      "answer": "iPhone 13 Pro Max specs are listed here:...",
      "status": "normal",
      "error": null,
      "message_files": [],
      "feedback": {
        "rating": "like"
      },
      "retriever_resources": [],
      "agent_thoughts": [],
      "created_at": 1705407629
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Query Parameters

​
conversation_id
string
required

Conversation ID.

​
user
string

User identifier.

​
first_id
string

The ID of the first chat record on the current page. Default is null (fetches the latest messages). For subsequent pages, use the ID of the first message from the current list to get older 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.