---
title: "Update Trait Group"
method: PATCH
path: "/v1/ControlPlane/Stores/{storeId}/TraitGroups/{traitGroupName}"
tags: ["TraitGroup"]
---

# Update Trait Group

`PATCH /v1/ControlPlane/Stores/{storeId}/TraitGroups/{traitGroupName}`

Partially 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, new keys will be added. To remove a trait, set its dataType to
an empty string ("") - this serves as an explicit deletion marker.

## Headers

- `If-Match` string

## Request body

- object
  - `description` string — Updated description of the Trait Group
  - `traits` object — Map of traits to add, update, or remove in this Trait Group, where the key is the trait name. - To update/add a trait: provide the complete TraitDefinition object - To remove a trait: set dataType to an empty string ("")

## Response `202`

TraitGroup update request accepted for processing.

- 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.

- **2026-08-11** (v1) `b0ed05460bbf` — 5 breaking, 1 info
  - 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`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `429`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `500`
  - …2 more

[Change history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/ControlPlane/Stores/:storeId/TraitGroups/:traitGroupName/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)