listConversations

Returns a list of Conversation objects

GET/conversations

Header parameters

x-user-keystringrequired

Authentication Key

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 Conversation objects

The response is of type listConversationsResponse · object.

conversationsobject[]required

metaobjectrequired

Request

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

Response

{
  "conversations": [
    {
      "id": "string",
      "createdAt": "2025-01-15T12:00:00Z",
      "updatedAt": "2025-01-15T12:00:00Z"
    }
  ],
  "meta": {
    "nextToken": "string"
  }
}