v2

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-072126235.6 KB
ConversationsV2Configuration

List Configurations

Retrieve a list of Configurations.

get/v2/ControlPlane/Configurations

Query parameters

pageSizeinteger
Example:50

Maximum number of items to return in a single response

pageTokenstring
Example:eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0=

A URL-safe, base64-encoded token representing the page of results to return

memoryStoreIdstring
Example:mem_store_01k1etk2y5f1y9fpe2epfdtvv2

Filter configurations by Memory Store ID

Response

OK

Example response

{
  "configurations": [
    {
      "id": "conv_configuration_01k1etk2y5f1y9fpe2epfdtvv2",
      "displayName": "Multi Channel Config",
      "description": "Configuration supporting SMS, WhatsApp, and RCS channels",
      "conversationGroupingType": "GROUP_BY_PROFILE",
      "memoryStoreId": "mem_store_01k1etk2y5f1y9fpe2epfdtvv2",
      "channelSettings": {
        "SMS": {
          "statusTimeouts": {
            "inactive": 10,
            "closed": 15
          },
          "captureRules": [
            {
              "from": "+18005550100",
              "to": "*",
              "metadata": {}
            }
          ]
        },
        "WHATSAPP": {
          "statusTimeouts": {
            "inactive": 15,
            "closed": 60
          },
          "captureRules": [
            {
              "from": "whatsapp:+18005550100",
              "to": "*",
              "metadata": {}
            }
          ]
        },
        "RCS": {
          "statusTimeouts": {
            "inactive": 15,
            "closed": 60
          },
          "captureRules": [
            {
              "from": "rcs:brand_acme_agent",
              "to": "*",
              "metadata": {}
            }
          ]
        }
      },
      "statusCallbacks": [
        {
          "url": "https://webhook.example.com/conversation/status",
          "method": "POST"
        }
      ],
      "intelligenceConfigurationIds": [],
      "memoryExtractionEnabled": false,
      "conversationsV1Bridge": {
        "serviceId": "IS00000000000000000000000000000000"
      },
      "createdAt": "2023-10-14T10:30:00Z",
      "updatedAt": "2023-10-14T15:45:30Z",
      "version": 1
    }
  ],
  "meta": {
    "key": "configurations",
    "pageSize": 20,
    "previousToken": "eyJwYWdlIjowLCJxdWVyeSI6ImJvb2tzIn0=",
    "nextToken": "eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0="
  }
}