---
title: "Update the name or userData of an existing Dynamic Person Group, and manage its members by adding or removing persons."
method: PATCH
path: "/dynamicpersongroups/{dynamicPersonGroupId}"
---

# Update the name or userData of an existing Dynamic Person Group, and manage its members by adding or removing persons.

`PATCH /dynamicpersongroups/{dynamicPersonGroupId}`

The properties keep unchanged if they are not in request body.

## Path parameters

- `dynamicPersonGroupId` string, required

## Request body

- object
  - `name` string — User defined name, maximum length is 128.
  - `userData` string — Optional user defined data. Length should not exceed 16K.
  - `addPersonIds` AzureCoreUuid[] — Array of personIds created by Person Directory "Create Person" to be added.
  - `removePersonIds` AzureCoreUuid[] — Array of personIds created by Person Directory "Create Person" to be removed.

## Response `202`

A successful call returns an empty response body. The service has accepted the request and will start processing soon. The client can query the operation status and result using the URL specified in the 'Operation-Location' response header. The URL expires in 48 hours. The URL provides the status of when Person Directory "Get Dynamic Person Group References" will return the changes made in this request.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `44e2cf82becd` — 1 info
  - endpoint added
- **2026-07-13** `e1f63ec9983b` — 1 info
  - endpoint added
- **2026-07-13** `5375faa8d134` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/dynamicpersongroups/:dynamicPersonGroupId/patch.md)

---

[API](https://skmtc.dev/azure/apis/ai-face.md) · [All operations](https://skmtc.dev/azure/apis/ai-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-face/revisions/44e2cf82becd/schema)