List messages

Paginated message history. Attachments include type and url (images and audio supported).

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Team API key (prefix sk_). You may also send the key via X-Api-Key header.

In: header

Path Parameters

agentId*string

conversationId*string

Query Parameters

page?number

Page number (1-based)

limit?number

Items per page (max 100)

search?string

Free-text search filter

sort?string

Sort field with optional leading "-" for descending (e.g. "-created_at").

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/console/agents/string/conversations/string/messages"

{  "message": "Success",  "meta": {    "total_count": 0,    "page_count": 0,    "current_page": 0,    "limit": 0,    "has_next_page": true,    "has_previous_page": true  },  "data": [    {      "id": "string",      "role": "string",      "message": "string",      "message_type": "string",      "created_at": "2019-08-24T14:15:22Z",      "attachments": [        {          "type": "image",          "url": "http://example.com"        }      ]    }  ]}