ConversationSummaries

List Conversation Summaries

Changed on

Retrieve a paginated list of conversation summaries for a specific profile. Supports response compression for large datasets.

get/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries

Request

  • Base URL
    https://memory.twilio.com
  • URL
    https://memory.twilio.com/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries
  • Auth
    HTTP basic

Query parameters

pageSizeinteger

The maximum number of items to return per page, maximum of 1000.

pageTokenstring

The token for the page of results to retrieve.

conversationIdstring

A unique identifier for the conversation using Twilio Type ID (TTID) format.

Example:conv_conversation_00000000000000000000000000

Filter by conversation ID. Returns only items associated with the specified conversation.

Headers

Accept-Encodingstring
Example:gzip, deflate, br

Compression algorithms supported by the client (e.g., gzip, deflate, br)

Response

A list of conversation summaries for the profile.

Example response

{
  "summaries": [
    {
      "source": "conversations",
      "content": "Customer discussed billing concerns and was satisfied with the resolution provided during this conversation.",
      "occurredAt": "2025-01-15T10:15:30Z",
      "conversationId": "conv_conversation_00000000000000000000000000",
      "id": "mem_summary_00000000000000000000000000",
      "createdAt": "2025-01-15T10:30:45Z",
      "updatedAt": "2025-01-15T10:30:45Z"
    }
  ],
  "meta": {
    "key": "observations",
    "nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",
    "previousToken": "eyJlYXN0ZXIiOiJlZ2cifQ"
  }
}

Changes

    • info

      the // response's property pattern was changed from ^[a-zA-Z0-9 _.-]+$ to ^[a-zA-Z0-9 _./-]+$ for the status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • info

      added the new optional query request parameter conversationId

    • info

      for the query request parameter pageToken, the maxLength was increased from 500 to 4096