listMessages

Retrieves the conversation's Messages

GET/conversations/{conversationId}/messages

Header parameters

x-user-keystringrequired

Authentication Key

Path parameters

conversationIdstringrequired

Conversation id

Query parameters

nextTokenstring

Provide the `meta.nextToken` value provided in the last API response to retrieve the next page of results

Response

application/json

Returns a list of Message objects

The response is of type listMessagesResponse · object.

messagesobject[]required

metaobjectrequired

Request

curl --request GET \ \
  --url https://chat.botpress.cloud/your_default_webhook_url/conversations/{conversationId}/messages \
  --header 'x-user-key: <x-user-key>' \
  --header 'Authorization: Bearer <token>'

Response

{
  "messages": [
    {
      "id": "string",
      "createdAt": "2025-01-15T12:00:00Z",
      "payload": {
        "audioUrl": "string",
        "type": "audio"
      },
      "userId": "string",
      "conversationId": "string"
    }
  ],
  "meta": {
    "nextToken": "string"
  }
}