DataMapping

List Data Mappings

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

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

Query parameters

pageSizeinteger

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

pageTokenstring

The token for the page of results to retrieve.

orderBy'ASC' | 'DESC'

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

type'INGRESS' | 'DATASET_CLOUDAPP' | 'DATASET_WAREHOUSE'

The type of data mapping defining how data flows into the Memory Store.

Example:DATASET_WAREHOUSE

Filter data mappings by type.

Response

DataMappings retrieved successfully.

Example response

{
  "dataMappings": [
    {
      "displayName": "crm-contacts",
      "description": "Syncs customer data from CRM dataset to profile traits",
      "isEnabled": true,
      "mappingTo": {
        "type": "TRAITS",
        "mappings": [
          {
            "expression": "primary_email",
            "traitGroup": "Contact",
            "traitName": "email"
          }
        ]
      },
      "mappingFrom": {
        "type": "INGRESS",
        "columns": [
          "first_name",
          "last_name",
          "email",
          "favorite_color"
        ]
      },
      "id": "mem_datamapping_00000000000000000000000000",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T11:45:00Z",
      "version": 3
    }
  ],
  "meta": {
    "nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",
    "previousToken": "eyJlYXN0ZXIiOiJlZ2cifQ"
  }
}

Changes

Changed in 3 of the 8 revisions of this API.1112

Aug 25, 2026v149499262215f22See the full diff
- ▲
  removed the enum value CSV from the query request parameter type
  request-parameter-enum-value-removed
- ▲
  removed the enum value DATASET from the query request parameter type
  request-parameter-enum-value-removed
- ○
  removed CSV DATASET discriminator mapping keys from the dataMappings/items/mappingFrom response property for the response status 200
  response-property-discriminator-mapping-deleted
- ○
  removed DataMappingFromCSV DataMappingFromDataSet from the dataMappings/items/mappingFrom response property oneOf list for the response status 200
  response-property-one-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 13, 2026v15fb6167593e714See the full diff
- ▲
  added DataMappingFromIngress DataMappingFromCloudAppDataSet DataMappingFromWarehouseDataSet to the dataMappings/items/mappingFrom response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added the new enum value DATASET_CLOUDAPP to the query request parameter type
  request-parameter-enum-value-added
- ○
  added the new enum value DATASET_WAREHOUSE to the query request parameter type
  request-parameter-enum-value-added
- ○
  added the new enum value INGRESS to the query request parameter type
  request-parameter-enum-value-added
- ○
  added INGRESS DATASET_CLOUDAPP DATASET_WAREHOUSE discriminator mapping keys to the dataMappings/items/mappingFrom response property for the response status 200
  response-property-discriminator-mapping-added
Aug 11, 2026v1b0ed05460bbf86See the full diff
- ▲
  for the query request parameter type, default value DATASET was removed
  request-parameter-default-value-removed
- ▲
  the code response property's max was increased from 99999.00 to 999999.00 for the response status 400
  response-property-max-increased
- ▲
  the code response property's max was increased from 99999.00 to 999999.00 for the response status 404
  response-property-max-increased
- ▲
  the code response property's max was increased from 99999.00 to 999999.00 for the response status 429
  response-property-max-increased
- ▲
  the code response property's max was increased from 99999.00 to 999999.00 for the response status 500
  response-property-max-increased
- ▲
  the code response property's max was increased from 99999.00 to 999999.00 for the response status 503
  response-property-max-increased
- ▲
  added DataMappingFromCSV to the dataMappings/items/mappingFrom response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  removed the required property dataMappings/items/mappingTo/oneOf[DataMappingToTraits]/mappings/items/fieldName from the response with the 200 status
  response-required-property-removed
- ○
  added the new enum value CSV to the query request parameter type
  request-parameter-enum-value-added
- ○
  for the query request parameter pageToken, the maxLength was increased from 500 to 4096
  request-parameter-max-length-increased
- ○
  the response property dataMappings/items/mappingTo/oneOf[DataMappingToTraits]/mappings/items/expression became required for the status 200
  response-property-became-required
- ○
  the pageSize response's property default value 50 was removed for the status 200
  response-property-default-value-removed
- ○
  added CSV discriminator mapping keys to the dataMappings/items/mappingFrom response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  the dataMappings/items/displayName response's property pattern was changed from ^[a-zA-Z][a-zA-Z0-9-_.]*$ to ^[a-zA-Z][a-zA-Z0-9-.]*$ for the status 200
  response-property-pattern-changed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 8 revisions, 1 has no diff computed.

Full history