---
title: "Update a Data Mapping"
method: PATCH
path: "/v1/ControlPlane/Stores/{storeId}/DataMappings/{dataMappingId}"
tags: ["DataMapping"]
---

# Update a Data Mapping

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

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_CLOUDAPP` and `DATASET_WAREHOUSE` types, validates that all mapped Trait Groups and traits exist
and that dataset field data types match their respective mapped trait data types.

## Headers

- `If-Match` string

## Request body

- DataMappingCore — Writable fields of a data mapping. Used directly as the PATCH request body (all fields optional). Composed into CreateDataMappingInput via allOf.
  - `displayName` string — Name of the data mapping.
  - `description` string — A human readable description of this resource, up to 512 characters.
  - `isEnabled` boolean — 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.
  - `mappingTo` DataMappingToTypes — Configuration for mapping data to traits in a Memory Store.
    - `type` 'TRAITS', required — The destination data type, which determines where to write the data and the required configuration parameters.
    - `mappings` MappingTraitItem[], required — The list of field to trait mappings.
      - `expression` string, required — The expression identifying the field/column in the source.
      - `traitGroup` string, required — The name of the Trait Group to map to.
      - `traitName` string, required — The name of the trait within the Trait Group to map to.

## Response `202`

Data mapping update request accepted.

- object
  - `message` string
  - `statusUrl` string — URI to check operation status.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

> 8 revisions in range; 1 not diffed, 1 could not be searched.

- **2026-08-11** (v1) `b0ed05460bbf` — 7 breaking, 2 warning
  - the request property `mappingTo/oneOf[#/components/schemas/DataMappingToTraits]/mappings/items/expression` became required
  - the `displayName` request property's maxLength was decreased to `64`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `400`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `404`
  - …5 more

[Change history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/ControlPlane/Stores/:storeId/DataMappings/:dataMappingId/patch.md)

---

[API](https://skmtc.dev/twilio/apis/memory-v1.md) · [All operations](https://skmtc.dev/twilio/apis/memory-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/memory-v1/revisions/14b76936cfa3/schema)