# Microsoft Azure AI Foundry Person Groups API

**Canonical:** https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-person-groups-api/  
**Provider:** Microsoft Azure AI Foundry — https://apis.io/providers/azure-ai-foundry/  
**Base URL:** https://{your-resource-name}.services.ai.azure.com  
**Documentation:** https://learn.microsoft.com/en-us/azure/ai-foundry/

Microsoft Azure AI Foundry Person Groups API is one of 36 APIs that [Microsoft Azure AI Foundry](https://apis.io/providers/azure-ai-foundry/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Person Groups. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, an engineering blog, and 6 JSON Schemas.

The Person Groups API from Microsoft Azure AI Foundry — 8 operation(s) for person groups.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/persongroups` | List Person Groups' personGroupId, name, userData and recognitionModel |
| GET | `/persongroups/{personGroupId}` | Person group operations get person group |
| PUT | `/persongroups/{personGroupId}` | Create a new Person Group with specified personGroupId, name, user-provided… |
| PATCH | `/persongroups/{personGroupId}` | Person group operations update person group |
| DELETE | `/persongroups/{personGroupId}` | Person group operations delete person group |
| GET | `/persongroups/{personGroupId}/persons` | List all persons' information in the specified Person Group, including… |
| POST | `/persongroups/{personGroupId}/persons` | Create a new person in a specified Person Group. |
| GET | `/persongroups/{personGroupId}/persons/{personId}` | Person group operations get person group person |
| PATCH | `/persongroups/{personGroupId}/persons/{personId}` | Person group operations update person group person |
| DELETE | `/persongroups/{personGroupId}/persons/{personId}` | Person group operations delete person group person |
| POST | `/persongroups/{personGroupId}/persons/{personId}/persistedfaces` | Add a face to a person into a Person Group for face identification or… |
| GET | `/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}` | Person group operations get person group person face |
| PATCH | `/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}` | Person group operations update person group person face |
| DELETE | `/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}` | Delete a face from a person in a Person Group by specified personGroupId… |
| POST | `/persongroups/{personGroupId}/train` | Submit a Person Group training task. |
| GET | `/persongroups/{personGroupId}/training` | Person group operations get person group training status |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/azure-ai-foundry/openapi/azure-ai-foundry-person-groups-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/rest/api/azureml/
- **APIReference** — https://learn.microsoft.com/en-us/azure/ai-foundry/
- **Authentication** — https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry
- **SDKs** — https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/ai
- **Documentation** — https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-microsoft-decision
- **Blog** — https://commandline.microsoft.com/microsoft-decision-1-model-foundry/
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-create-collection-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-training-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-person-group-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-person-group-person-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-add-face-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-person-group-person-face-schema.json

## Other Microsoft Azure AI Foundry APIs (12)

- [Azure AI Foundry REST API](https://apis.io/apis/azure-ai-foundry/foundry-api/)
- [Microsoft Azure AI Foundry Operations API](https://apis.io/apis/azure-ai-foundry/microsoft-azure-ai-foundry-operations-api/)
- [Microsoft Azure AI Foundry Analyzer Results API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-analyzerresults-api/)
- [Microsoft Azure AI Foundry Analyzers API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-analyzers-api/)
- [Microsoft Azure AI Foundry Assistants API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-assistants-api/)
- [Microsoft Azure AI Foundry Connections API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-connections-api/)
- [Microsoft Azure AI Foundry Datasets API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-datasets-api/)
- [Microsoft Azure AI Foundry Defaults API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-defaults-api/)
- [Microsoft Azure AI Foundry Deployments API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-deployments-api/)
- [Microsoft Azure AI Foundry Detect API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-detect-api/)
- [Microsoft Azure AI Foundry DetectLiveness Sessions API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-detectliveness-sessions-api/)
- [Microsoft Azure AI Foundry DetectLivenessWithVerify Sessions API](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-detectlivenesswithverify-sessions-api/)

## Tags

Person Groups

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-person-groups-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/azure-ai-foundry/.