Skip to content Skip to navigation Skip to topbar

Memory API (v1) - Data Mapping endpoints

(information)

Legal information

Conversation Memory, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum. For more details on AI usage and data, see the AI Nutrition Facts.

Conversation Memory is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

Conversation Memory is not intended for use with sensitive information about individuals. Twilio does not control what information comes from conversation channels and relies on you to ensure the data in customer profiles aligns with our acceptable use policy. Twilio does have limited guardrails in the form of a prompt exclusion that is designed to provide a minimal screening against inclusion of GDPR special category data. As a reminder our profile technology uses generative artificial intelligence. Because generative artificial intelligence can make mistakes, review all outputs to ensure that the profile is correct.

Conversations products are only available in the new Twilio Console. If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

Overview

Tag description

Endpoints

/v1/ControlPlane/Stores/{storeId}/DataMappings

Create a Data Mapping

/v1/ControlPlane/Stores/{storeId}/DataMappings

List Data Mappings

/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Retrieve a Data Mapping

/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Update a Data Mapping

/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Delete a Data Mapping

Create a Data Mapping

POST/v1/ControlPlane/Stores/{storeId}/DataMappings

Base url: https://memory.twilio.com (base url)

Create a new data mapping to connect an external data source to this Memory Store. For DATASET types, validates that all mapped Trait Groups and traits exist and that dataset field data types match their respective mapped trait data types.

Request

Security: Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

storeIdstring

required

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$

Request body

Encoding type:application/json

Schema

Property nameTypeRequiredPIIDescriptionChild properties

displayNamestring

required

Name of the data mapping.

Example: crm-contactsPattern: ^[a-zA-Z][a-zA-Z0-9-_.]*$Min length: 1Max length: 128

descriptionstring

Optional

A human readable description of this resource, up to 512 characters.

Example: Syncs customer data from CRM dataset to profile traitsMin length: 1Max length: 512

isEnabledboolean

Optional

Flag indicating whether the data mapping is active. When true, data will be ingested and mapped according to the configuration. When false, the data mapping will be inactive and no data will be ingested into the Memory Store.

Default: trueExample: true

mappingTo

oneOf:

required

Details of where to map data items to. Each data mapping to type has its own set of configuration parameters and destination specific properties.

Example: {"type":"TRAITS","mappings":[{"fieldName":"primary_email","traitGroup":"Contact","traitName":"email"}]}

Show mappingTo properties

mappingFrom

oneOf:

required

Details of where to map data items from. Each data mapping from type has its own set of configuration parameters and source specific properties.

Example: {"type":"DATASET","datasetId":"tdi_dataset_00000000000000000000000000"}

Show mappingFrom properties

Responses

202400404409429500503

Data mapping creation request accepted.

Schema

Property nameTypeRequiredPIIDescriptionChild properties

messagestring

Optional

Example: Data mapping creation request accepted for processing.Max length: 512

statusUrlstring

Optional

URI to check operation status.

Max length: 512

Bad Request

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Not Found

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Conflict

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

This error indicates that you have sent too many requests to the API. You should retry according to the Retry-After response header.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Internal Server Error

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Service Unavailable

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Create a Data Mapping

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createDataMapping() {
11  const dataMapping = await client.memory.v1
12    .dataMappings("mem_store_00000000000000000000000000")
13    .create({
14      displayName: "crm-contacts",
15      mappingTo: {
16        type: "TRAITS",
17        mappings: [
18          {
19            fieldName: "fieldName",
20            expression: "expression",
21            traitGroup: "Contact",
22            traitName: "email",
23          },
24        ],
25      },
26      mappingFrom: {
27        type: "DATASET",
28        datasetId: "tdi_dataset_00000000000000000000000000",
29      },
30    });
31
32  console.log(dataMapping.message);
33}
34
35createDataMapping();

Response

1{
2  "message": "message",
3  "statusUrl": "statusUrl"
4}

List Data Mappings

GET/v1/ControlPlane/Stores/{storeId}/DataMappings

Base url: https://memory.twilio.com (base url)

Get a list of data mappings configured for this Memory Store.

Request

Security: Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

storeIdstring

required

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$

Query string

Property nameTypeRequiredPIIDescription

pageSizeinteger

Optional

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

Default: 50Minimum: 1Maximum: 100

pageTokenstring

Optional

The token for the page of results to retrieve.

Max length: 500

orderByenum<string>

Optional

Either 'ASC' or 'DESC' to sort results ascending or descending respectively.

Default: DESCPossible values:

ASCDESC

typeenum<string>

Optional

Filter data mappings by type.

Default: DATASETExample: DATASETPossible values:

DATASET

Responses

200400404429500503

DataMappings retrieved successfully.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

dataMappingsarray[object]

Optional

List of DataMappings associated with the Memory Store.

Max items: 100

Show dataMappings properties

Property nameTypeRequiredPIIDescriptionChild properties

displayNamestring

Optional

Name of the data mapping.

Example: crm-contactsPattern: ^[a-zA-Z][a-zA-Z0-9-_.]*$Min length: 1Max length: 128

descriptionstring

Optional

A human readable description of this resource, up to 512 characters.

Example: Syncs customer data from CRM dataset to profile traitsMin length: 1Max length: 512

isEnabledboolean

Optional

Flag indicating whether the data mapping is active. When true, data will be ingested and mapped according to the configuration. When false, the data mapping will be inactive and no data will be ingested into the Memory Store.

Default: trueExample: true

mappingTo

oneOf:

Optional

Details of where to map data items to. Each data mapping to type has its own set of configuration parameters and destination specific properties.

Example: {"type":"TRAITS","mappings":[{"fieldName":"primary_email","traitGroup":"Contact","traitName":"email"}]}

Show mappingTo properties

mappingFrom

oneOf:

Optional

Details of where to map data items from. Each data mapping from type has its own set of configuration parameters and source specific properties.

Example: {"type":"DATASET","datasetId":"tdi_dataset_00000000000000000000000000"}

Show mappingFrom properties

idstring

Optional

The unique identifier for the data mapping.

Example: mem_datamapping_00000000000000000000000000Pattern: ^mem_datamapping_[0-7][0-9a-z]{25}$

createdAtstring<date-time>

Optional

The ISO 8601 timestamp when the data mapping was created.

Example: 2026-01-15T10:30:00Z

updatedAtstring<date-time>

Optional

The ISO 8601 timestamp when the data mapping was last updated.

Example: 2026-01-15T11:45:00Z

versioninteger

Optional

The current version number of the DataMapping. Incremented on each successful update.

Example: 3Minimum: 1

metaobject

Optional

Show meta properties

Bad Request

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Not Found

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

This error indicates that you have sent too many requests to the API. You should retry according to the Retry-After response header.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Internal Server Error

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Service Unavailable

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

List Data Mappings

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listDataMappings() {
11  const dataMappings = await client.memory.v1
12    .dataMappings("mem_store_00000000000000000000000000")
13    .list({
14      orderBy: "DESC",
15      type: "DATASET",
16      limit: 20,
17    });
18
19  dataMappings.forEach((d) => console.log(d.displayName));
20}
21
22listDataMappings();

Response

1{
2  "dataMappings": [
3    {
4      "displayName": "crm-contacts",
5      "description": "description",
6      "isEnabled": true,
7      "mappingTo": {},
8      "mappingFrom": {},
9      "id": "mem_datamapping_00000000000000000000000000",
10      "createdAt": "2009-07-06T20:30:00Z",
11      "updatedAt": "2009-07-06T20:30:00Z",
12      "version": 3
13    }
14  ],
15  "meta": {
16    "key": "key",
17    "pageSize": 50,
18    "nextToken": "nextToken",
19    "previousToken": "previousToken"
20  }
21}

Retrieve a Data Mapping

GET/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Base url: https://memory.twilio.com (base url)

Retrieve the details of a specific data mapping by its unique ID.

Request

Security: Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

storeIdstring

required

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$

dataMappingIdstring

required

A unique DataMapping ID using Twilio Type ID (TTID) format

Example: mem_datamapping_00000000000000000000000000Pattern: ^mem_datamapping_[0-7][0-9a-z]{25}$

Responses

200400404429500503

Data mapping details retrieved successfully.

Schema

Property nameTypeRequiredPIIDescriptionChild properties

displayNamestring

Optional

Name of the data mapping.

Example: crm-contactsPattern: ^[a-zA-Z][a-zA-Z0-9-_.]*$Min length: 1Max length: 128

descriptionstring

Optional

A human readable description of this resource, up to 512 characters.

Example: Syncs customer data from CRM dataset to profile traitsMin length: 1Max length: 512

isEnabledboolean

Optional

Flag indicating whether the data mapping is active. When true, data will be ingested and mapped according to the configuration. When false, the data mapping will be inactive and no data will be ingested into the Memory Store.

Default: trueExample: true

mappingTo

oneOf:

Optional

Details of where to map data items to. Each data mapping to type has its own set of configuration parameters and destination specific properties.

Example: {"type":"TRAITS","mappings":[{"fieldName":"primary_email","traitGroup":"Contact","traitName":"email"}]}

Show mappingTo properties

mappingFrom

oneOf:

Optional

Details of where to map data items from. Each data mapping from type has its own set of configuration parameters and source specific properties.

Example: {"type":"DATASET","datasetId":"tdi_dataset_00000000000000000000000000"}

Show mappingFrom properties

idstring

Optional

The unique identifier for the data mapping.

Example: mem_datamapping_00000000000000000000000000Pattern: ^mem_datamapping_[0-7][0-9a-z]{25}$

createdAtstring<date-time>

Optional

The ISO 8601 timestamp when the data mapping was created.

Example: 2026-01-15T10:30:00Z

updatedAtstring<date-time>

Optional

The ISO 8601 timestamp when the data mapping was last updated.

Example: 2026-01-15T11:45:00Z

versioninteger

Optional

The current version number of the DataMapping. Incremented on each successful update.

Example: 3Minimum: 1

Bad Request

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Not Found

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

This error indicates that you have sent too many requests to the API. You should retry according to the Retry-After response header.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Internal Server Error

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Service Unavailable

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Retrieve a Data Mapping

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function fetchDataMapping() {
11  const dataMapping = await client.memory.v1
12    .dataMappings(
13      "mem_store_00000000000000000000000000",
14      "mem_datamapping_00000000000000000000000000"
15    )
16    .fetch();
17
18  console.log(dataMapping.displayName);
19}
20
21fetchDataMapping();

Response

1{
2  "createdAt": "2009-07-06T20:30:00Z",
3  "description": "description",
4  "displayName": "crm-contacts",
5  "id": "mem_datamapping_00000000000000000000000000",
6  "isEnabled": true,
7  "mappingFrom": {},
8  "mappingTo": {},
9  "updatedAt": "2009-07-06T20:30:00Z",
10  "version": 3
11}

Update a Data Mapping

PATCH/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Base url: https://memory.twilio.com (base url)

Partially update a data mapping. Only the fields provided in the request body will be updated, including replacing the entire contents of the mappings array.

For DATASET types, validates that all mapped Trait Groups and traits exist and that dataset field data types match their respective mapped trait data types.

Request

Security: Basic Auth

Headers

Property nameTypeRequiredPIIDescription

if-Matchstring

Optional

Allows for optimistic concurrency control by making the request conditional. Server will only act if the resource's current Entity Tag (ETag) matches the one provided, preventing accidental overwrites.

Example: "eyJpZCI6ImFuX2lkIiwidiI6MX0"Max length: 100

Path parameters

Property nameTypeRequiredPIIDescription

storeIdstring

required

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$

dataMappingIdstring

required

A unique DataMapping ID using Twilio Type ID (TTID) format

Example: mem_datamapping_00000000000000000000000000Pattern: ^mem_datamapping_[0-7][0-9a-z]{25}$

Request body

Encoding type:application/json

Schema

Property nameTypeRequiredPIIDescriptionChild properties

displayNamestring

Optional

Name of the data mapping.

Example: crm-contactsPattern: ^[a-zA-Z][a-zA-Z0-9-_.]*$Min length: 1Max length: 128

descriptionstring

Optional

A human readable description of this resource, up to 512 characters.

Example: Syncs customer data from CRM dataset to profile traitsMin length: 1Max length: 512

isEnabledboolean

Optional

Flag indicating whether the data mapping is active. When true, data will be ingested and mapped according to the configuration. When false, the data mapping will be inactive and no data will be ingested into the Memory Store.

Default: trueExample: true

mappingTo

oneOf:

Optional

Details of where to map data items to. Each data mapping to type has its own set of configuration parameters and destination specific properties.

Example: {"type":"TRAITS","mappings":[{"fieldName":"primary_email","traitGroup":"Contact","traitName":"email"}]}

Show mappingTo properties

Responses

202400404429500503

Data mapping update request accepted.

Schema

Property nameTypeRequiredPIIDescriptionChild properties

messagestring

Optional

Example: Data mapping update request accepted for processing.Max length: 512

statusUrlstring

Optional

URI to check operation status.

Max length: 512

Bad Request

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Not Found

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

This error indicates that you have sent too many requests to the API. You should retry according to the Retry-After response header.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Internal Server Error

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Service Unavailable

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Update a Data Mapping

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function patchDataMapping() {
11  const dataMapping = await client.memory.v1
12    .dataMappings(
13      "mem_store_00000000000000000000000000",
14      "mem_datamapping_00000000000000000000000000"
15    )
16    .patch({
17      displayName: "crm-contacts",
18    });
19
20  console.log(dataMapping.message);
21}
22
23patchDataMapping();

Response

1{
2  "message": "message",
3  "statusUrl": "statusUrl"
4}

Delete a Data Mapping

DELETE/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}

Base url: https://memory.twilio.com (base url)

Delete a data mapping from the Memory Store. This action cannot be undone.

Request

Security: Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

storeIdstring

required

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$

dataMappingIdstring

required

A unique DataMapping ID using Twilio Type ID (TTID) format

Example: mem_datamapping_00000000000000000000000000Pattern: ^mem_datamapping_[0-7][0-9a-z]{25}$

Responses

202400404429500503

Data mapping deletion request accepted.

Schema

Property nameTypeRequiredPIIDescriptionChild properties

messagestring

Optional

Example: Data mapping deletion request accepted for processing.Max length: 512

statusUrlstring

Optional

URI to check operation status.

Max length: 512

Bad Request

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Not Found

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

This error indicates that you have sent too many requests to the API. You should retry according to the Retry-After response header.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Internal Server Error

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Service Unavailable

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

The Twilio error code.

Minimum: 100Maximum: 99999

messagestring

Optional

A human readable message describing the error.

Max length: 1024

moreInfostring

Optional

A URL to a Twilio error directory page with more information about the error code.

statusinteger<int32>

Optional

The HTTP status code for the error.

Minimum: 100Maximum: 599

Delete a Data Mapping

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function deleteDataMapping() {
11  await client.memory.v1
12    .dataMappings(
13      "mem_store_00000000000000000000000000",
14      "mem_datamapping_00000000000000000000000000"
15    )
16    .remove();
17}
18
19deleteDataMapping();

Response

1{
2  "message": "message",
3  "statusUrl": "statusUrl"
4}