Face Client Skill
azure-com-cognitiveservices-face
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /findsimilars | |
POST | /group | Given query face's faceId, to search the similar-looking faces from a faceId array, a face list or a large face list. faceId array contains the faces created by [Face - Detect Wit... |
POST | /identify | Divide candidate faces into groups based on face similarity. |
POST | /verify | 1-to-many identification to find the closest matches of the specific query person face from a person group or large person group. |
POST | /persongroups/{personGroupId}/persons | Verify whether two faces belong to a same person or whether one face belongs to a person. |
GET | /persongroups/{personGroupId}/persons | Create a new person in a specified person group. |
DELETE | /persongroups/{personGroupId}/persons/{personId} | List all persons in a person group, and retrieve person information (including personId, name, userData and persistedFaceIds of registered faces of the person). |
GET | /persongroups/{personGroupId}/persons/{personId} | Delete an existing person from a person group. The persistedFaceId, userData, person name and face feature in the person entry will all be deleted. |
PATCH | /persongroups/{personGroupId}/persons/{personId} | Retrieve a person's information, including registered persisted faces, name and userData. |
DELETE | /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId} | Update name or userData of a person. |
GET | /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId} | Delete a face from a person in a person group by specified personGroupId, personId and persistedFaceId. |
PATCH | /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId} | Retrieve information about a persisted face (specified by persistedFaceId, personId and its belonging personGroupId). |
PUT | /persongroups/{personGroupId} | Add a face to a person into a person group for face identification or verification. To deal with an image contains multiple faces, input face can be specified as an image with a t... |
DELETE | /persongroups/{personGroupId} | Create a new person group with specified personGroupId, name, user-provided userData and recognitionModel. |
GET | /persongroups/{personGroupId} | Delete an existing person group. Persisted face features of all people in the person group will also be deleted. |
PATCH | /persongroups/{personGroupId} | Retrieve person group name, userData and recognitionModel. To get person information under this personGroup, use [PersonGroup Person - List](https://docs.microsoft.com/rest/api/fa... |
GET | /persongroups/{personGroupId}/training | Update an existing person group's display name and userData. The properties which does not appear in request body will not be updated. |
GET | /persongroups | Retrieve the training status of a person group (completed or ongoing). |
POST | /persongroups/{personGroupId}/train | List person groups’ personGroupId, name, userData and recognitionModel. |
PUT | /facelists/{faceListId} | Queue a person group training task, the training task may not be started immediately. |
GET | /facelists/{faceListId} | Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to 64 face lists are allowed in one subscription. |
PATCH | /facelists/{faceListId} | Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list. |
DELETE | /facelists/{faceListId} | Update information of a face list. |
GET | /facelists | Delete a specified face list. |
DELETE | /facelists/{faceListId}/persistedfaces/{persistedFaceId} | List face lists’ faceListId, name, userData and recognitionModel. |
POST | /persongroups/{personGroupId}/persons/{personId}/persistedfaces | Delete a face from a face list by specified faceListId and persistedFaceId. |
POST | /detect | Add a face to a person into a person group for face identification or verification. To deal with an image contains multiple faces, input face can be specified as an image with a t... |
POST | /facelists/{faceListId}/persistedfaces | Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and attributes. |
POST | /largepersongroups/{largePersonGroupId}/persons | Add a face to a specified face list, up to 1,000 faces. |
GET | /largepersongroups/{largePersonGroupId}/persons | Create a new person in a specified large person group. |
Install as Skill
Use this API as a Claude Code skill for instant agent access.
CLI Install
lapsh skill-install azure-com-cognitiveservices-face
Downloads and installs to ~/.claude/skills/azure-com-cognitiveservices-face/
Recent Versions (1)
1.0(2026-02-13)