# Microsoft Azure AI Foundry Facelists API

**Canonical:** https://apis.io/apis/azure-ai-foundry/azure-ai-foundry-facelists-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 Facelists 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 Facelists. 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 Facelists API from Microsoft Azure AI Foundry — 4 operation(s) for facelists.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/facelists` | Face list operations get face lists |
| GET | `/facelists/{faceListId}` | Face list operations get face list |
| PUT | `/facelists/{faceListId}` | Create an empty Face List with user-specified faceListId, name, an optional… |
| PATCH | `/facelists/{faceListId}` | Face list operations update face list |
| DELETE | `/facelists/{faceListId}` | Face list operations delete face list |
| POST | `/facelists/{faceListId}/persistedfaces` | Add a face to a specified Face List, up to 1,000 faces |
| DELETE | `/facelists/{faceListId}/persistedfaces/{persistedFaceId}` | Delete a face from a Face List by specified faceListId and persistedFaceId |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/azure-ai-foundry/openapi/azure-ai-foundry-facelists-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-face-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-face-list-item-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-user-defined-fields-for-update-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-ai-foundry/json-schema/azure-ai-foundry-add-face-from-url-request-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

Facelists

---

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