Twilio Memory API
APIs for managing memory stores, profiles, and conversational intelligence capabilities.
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
APIs for managing memory stores, profiles, and conversational intelligence capabilities.
Endpoints 46
Store
- GETList Memory Stores
/v1/ControlPlane/Stores?pageSize=50&pageToken=string&orderBy=DESCGet a list of memory stores for the Twilio account. - POSTCreate a Memory Store
/v1/ControlPlane/StoresCreate a new Memory Store for the Twilio account. Accounts can have multiple memory stores, up to a maximum limit of 15. Each memory store will automatically… - GETRetrieve a Memory Store.
/v1/ControlPlane/Stores/:storeIdRetrieve the details of a specific Memory Store by its unique ID. - DELETEDelete a Memory Store
/v1/ControlPlane/Stores/:storeIdDeletes the Memory Store and all associated resources including identity resolution settings, trait groups, profiles, traits, observations, and summaries. - PATCHUpdate a Memory Store
/v1/ControlPlane/Stores/:storeIdPartially update a Memory Store. Only the fields provided in the request body will be updated.
TraitGroup
- GETList Trait Groups
/v1/ControlPlane/Stores/:storeId/TraitGroups?includeTraits=false&pageSize=50&pageToken=string&orderBy=DESCReturns a list of Trait Groups for this Memory Store, with optional traits information. - POSTCreate a Trait Group
/v1/ControlPlane/Stores/:storeId/TraitGroupsCreates a Trait Group with declarative trait schemas for this Memory Store. - GETRetrieve a Trait Group
/v1/ControlPlane/Stores/:storeId/TraitGroups/:traitGroupName?includeTraits=true&pageSize=50&pageToken=string&orderBy=DESCRetrieve a specific Trait Group by its unique name for this Memory Store, with optional traits information. - DELETEDelete a Trait Group
/v1/ControlPlane/Stores/:storeId/TraitGroups/:traitGroupNameDeletes the Trait Group and all associated Traits from the Memory Store. - PATCHUpdate Trait Group
/v1/ControlPlane/Stores/:storeId/TraitGroups/:traitGroupNamePartially updates a Trait Group. Only the fields provided in the request body will be updated. For traits: existing traits with matching keys will be updated,…
IdentityResolutionSettings
- GETRetrieve Identity Resolution Settings.
/v1/ControlPlane/Stores/:storeId/IdentityResolutionSettingsThese settings determine how Customer Memory will use identifiers for searching, merging, and resolving profiles. > Some settings can only take on their… - PUTUpdate Identity Resolution Settings.
/v1/ControlPlane/Stores/:storeId/IdentityResolutionSettingsUpdate the identity resolution settings for this memory store, which determine how Customer Memory will use identifiers for searching, merging, and resolving…
DataMapping
- GETList Data Mappings
/v1/ControlPlane/Stores/:storeId/DataMappings?pageSize=50&pageToken=string&orderBy=DESC&type=DATASET_WAREHOUSEGet a list of data mappings configured for this Memory Store. - POSTCreate a Data Mapping
/v1/ControlPlane/Stores/:storeId/DataMappingsCreate a new data mapping to connect an external data source to this Memory Store. For DATASET_CLOUDAPP and DATASET_WAREHOUSE types, validates that all mapped… - GETRetrieve a Data Mapping
/v1/ControlPlane/Stores/:storeId/DataMappings/:dataMappingIdRetrieve the details of a specific data mapping by its unique ID. - DELETEDelete a Data Mapping
/v1/ControlPlane/Stores/:storeId/DataMappings/:dataMappingIdDelete a data mapping from the Memory Store. This action cannot be undone. - PATCHUpdate a Data Mapping
/v1/ControlPlane/Stores/:storeId/DataMappings/:dataMappingIdPartially update a data mapping. Only the fields provided in the request body will be updated, including replacing the entire contents of the mappings array.…
Operations
- GETGet Operation Status
/v1/ControlPlane/Operations/:operationIdRetrieve the status and result of an asynchronous operation.
Profile
- GETGet Profile
/v1/Stores/:storeId/Profiles/:profileId?traitGroups=ContactRetrieve profile traits by profile ID. Use the traitGroups query parameter to restrict results to a comma-separated allow list of trait group names. For large… - DELETEDelete Profile
/v1/Stores/:storeId/Profiles/:profileIdAsynchronously delete the profile permanently and all associated identifiers and traits. This operation is irreversible. Downstream caches or analytical… - PATCHPatch Profile
/v1/Stores/:storeId/Profiles/:profileIdUpdate or add specific traits to an existing profile. Only the traits provided are added or updated; unspecified traits remain unchanged. Only pre-defined… - GETList Profiles
/v1/Stores/:storeId/Profiles?pageSize=50&pageToken=string&orderBy=DESCReturn a paginated list of profile IDs ordered by most recently created first. Use the optional paging parameters (pageSize, pageToken, orderBy) to control… - POSTCreate Profile
/v1/Stores/:storeId/ProfilesCreate a new profile and set initial traits. The request synchronously resolves identity and either creates a new profile ID or retrieves the associated… - PUTBulk Upsert Profiles
/v1/Stores/:storeId/Profiles/BulkCreate or update up to 1000 profiles in a single asynchronous batch. Each profile body follows the same structure as single profile creation. If a profile… - GETGet a list of imports
/v1/Stores/:storeId/Profiles/Imports?pageSize=50&pageToken=string&orderBy=DESCRetrieve a paginated list of profile import task IDs submitted for this service, ordered by import recency. Use the returned IDs to query individual import… - POSTImport Profiles
/v1/Stores/:storeId/Profiles/ImportsInitiate a profile import by requesting a pre-signed upload URL and an associated importId. Upload your CSV to the returned URL (single PUT). Query the import… - GETGet Import Status
/v1/Stores/:storeId/Profiles/Imports/:importIdRetrieve the current processing status of a previously submitted bulk import task. Query this endpoint using the importId returned from the upload URL request…
Retrieval
- POSTLookup Profiles
/v1/Stores/:storeId/Profiles/LookupFind profiles that contain a specific identifier value (for example a phone number or email address). Submit an identifier object specifying the idType and… - POSTRetrieve Memories
/v1/Stores/:storeId/Profiles/:profileId/RecallTailored memory retrieval for agentic workloads. Supports hybrid semantic search, date ranges, and configurable result limits for different memory types. This…
Identifiers
- GETList Profile Identifiers
/v1/Stores/:storeId/Profiles/:profileId/IdentifiersRetrieve all identifier types linked to a profile along with their stored values. Use this to audit which external keys (phone, email, externalId, etc.) are… - POSTAdd Profile Identifier
/v1/Stores/:storeId/Profiles/:profileId/IdentifiersAsynchronously attach a new identifier value to a profile. When multiple values exist for an idType, ordering, limits, and uniqueness checks are enforced by… - GETRetrieve Profile Identifier
/v1/Stores/:storeId/Profiles/:profileId/Identifiers/:idTypeRetrieve all stored values for a specific identifier type on a profile. Values are normalized according to the configured identifier settings and returned in… - DELETERemove Profile Identifier
/v1/Stores/:storeId/Profiles/:profileId/Identifiers/:idType?removeAll=falseAsynchronously remove stored values for the identifier type. The optional removeAll query parameter allows bulk removal; otherwise the service selects a… - PATCHModify Profile Identifier
/v1/Stores/:storeId/Profiles/:profileId/Identifiers/:idTypeAsynchronously replace one of the stored values associated with the identifier type on a profile. newValue is normalized according to the configured…
Traits
- GETList Profile Traits
/v1/Stores/:storeId/Profiles/:profileId/Traits?pageSize=50&pageToken=string&orderBy=DESC&traitGroups=ContactReturn a paginated, optionally filtered list of individual traits for a profile (flattened view). This is useful for UIs or tools that need to browse trait…
Observations
- GETList Observations
/v1/Stores/:storeId/Profiles/:profileId/Observations?pageSize=50&pageToken=string&orderBy=DESC&source=customer service platform&createdAfter=2025-01-01T00:00:00Z&createdBefore=2025-01-31T23:59:59Z&conversationId=conv_conversation_00000000000000000000000000Retrieve a paginated list of transient observations for a specific profile. Observations are sorted by creation time in descending order by default. Results… - POSTCreate Observations
/v1/Stores/:storeId/Profiles/:profileId/ObservationsCreate one or more transient observations associated with the specified profile. Supports both single observation creation and batch creation of up to 10… - GETRetrieve Observation
/v1/Stores/:storeId/Profiles/:profileId/Observations/:observationIdRetrieve a specific transient observation by its ID for the given profile. - DELETEDelete Observation
/v1/Stores/:storeId/Profiles/:profileId/Observations/:observationIdDelete a specific transient observation by its ID. This action is irreversible. - PATCHUpdate Observation
/v1/Stores/:storeId/Profiles/:profileId/Observations/:observationIdUpdate a specific transient observation by its ID. Only provided fields will be updated. The updated timestamp will be automatically set. This allows for… - GETList Observation Revisions
/v1/Stores/:storeId/Profiles/:profileId/Observations/:observationId/Revisions?pageSize=50&pageToken=stringRetrieve a chronologically ordered list of all past revisions of a specific observation by its ID. Revisions represent the complete history of updates and…
ConversationSummaries
- GETList Conversation Summaries
/v1/Stores/:storeId/Profiles/:profileId/ConversationSummaries?pageSize=50&pageToken=string&conversationId=conv_conversation_00000000000000000000000000Retrieve a paginated list of conversation summaries for a specific profile. Supports response compression for large datasets. - POSTCreate Conversation Summaries
/v1/Stores/:storeId/Profiles/:profileId/ConversationSummariesCreate one or more conversation summaries associated with the specified profile. Supports both single summary creation and batch creation of up to 10… - GETRetrieve Conversation Summary
/v1/Stores/:storeId/Profiles/:profileId/ConversationSummaries/:summaryIdRetrieve a specific conversation summary by its ID for the given profile. - DELETEDelete Conversation Summary
/v1/Stores/:storeId/Profiles/:profileId/ConversationSummaries/:summaryIdDelete a specific conversation summary by its ID. This action is irreversible. - PATCHUpdate Conversation Summary
/v1/Stores/:storeId/Profiles/:profileId/ConversationSummaries/:summaryIdPartially update a specific conversation summary by its ID. Only provided fields will be updated. The updated timestamp will be automatically set. This allows…
API details
- Base URL
https://memory.twilio.com- Authentication
- HTTP Basic authentication (username and password)
HTTP Basic authentication (username and password) - Operations
- 46 operations on 23 pathsGET 20POST 10PATCH 7DELETE 7PUT 2
- Main resources
- Profile 9Observations 6ConversationSummaries 5DataMapping 5Identifiers 5Store 5TraitGroup 5IdentityResolutionSettings 2Retrieval 2Operations 1
- Response formats
application/json- Description format
- OpenAPI 3.0.1, API version
1.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- Twilio's published OpenAPI description (twilio/twilio-oai) (MIT)
How to test the Twilio Memory API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Twilio Memory API collection, without the publisher's secrets.
- Add your credentialsThis API uses HTTP Basic authentication (username and password). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List Memory Stores” (GET /v1/ControlPlane/Stores?pageSize=50&pageToken=string&orderBy=DESC), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Twilio Memory API?
APIs for managing memory stores, profiles, and conversational intelligence capabilities. It is listed under Communication and has 46 endpoints.
Who publishes the Twilio Memory API?
It is listed from Twilio's public API description (an OpenAPI document), not published by Twilio on Swastik Codes. Anyone who controls twilio.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Twilio Memory API?
Requests go to https://memory.twilio.com. Endpoint paths are added to this base URL.
How do I authenticate with the Twilio Memory API?
It accepts 2 methods: HTTP Basic authentication (username and password); HTTP Basic authentication (username and password).
How many endpoints does the Twilio Memory API have?
46 operations on 23 paths (20 GET, 10 POST, 7 PATCH, 7 DELETE, 2 PUT). The largest groups are Profile, Observations, ConversationSummaries, DataMapping.
Is forking the Twilio Memory API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.