---
title: "Changes to Creates a new dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData.\r\nA dynamic person group is a container that references persons.\r\nAfter creation, use \"DynamicPersonGroup - Update\" to add/remove persons into the search space.\r\nDynamicPersonGroup and UserData will be stored on server until DynamicPersonGroup Delete is called."
method: PUT
path: "/dynamicpersongroups/{dynamicPersonGroupId}"
---

# Changes to Creates a new dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData.
A dynamic person group is a container that references persons.
After creation, use "DynamicPersonGroup - Update" to add/remove persons into the search space.
DynamicPersonGroup and UserData will be stored on server until DynamicPersonGroup Delete is called.

`PUT /dynamicpersongroups/{dynamicPersonGroupId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 28 revisions.

- **2026-07-13** `8a19b734b92a` — 1 info
- **2017-12-28** `e67414f9aeba` — 1 breaking

## Changes

- **2026-07-13** `8a19b734b92a` — 1 info
  - endpoint added
- **2017-12-28** `e67414f9aeba` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/azure/apis/cognitiveservices-face/docs/dynamicpersongroups/:dynamicPersonGroupId/put.md) · [API](https://skmtc.dev/azure/apis/cognitiveservices-face.md) · [Page](https://skmtc.dev/azure/apis/cognitiveservices-face/changes/dynamicpersongroups/:dynamicPersonGroupId/put)