Person Group Person - Delete Face

Service:

Cognitive Services - Face

API Version:

1.0

Delete a face from a person in a person group by specified personGroupId, personId and persistedFaceId.
Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from different persons are processed in parallel.

DELETE {Endpoint}/face/v1.0/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}

URI Parameters

Name	In	Required	Type	Description
Endpoint	path	True	string	Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).
persistedFaceId	path	True	string uuid	Id referencing a particular persistedFaceId of an existing face.
personGroupId	path	True	string	Id referencing a particular person group. Regex pattern: ^[a-z0-9-_]+$
personId	path	True	string uuid	Id referencing a particular person.

Request Header

Name	Required	Type	Description
Ocp-Apim-Subscription-Key	True	string

Responses

Name	Type	Description
200 OK		A successful call returns an empty response body.
Other Status Codes	APIError	Error response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Delete face from person example

Sample Request

HTTP

DELETE {Endpoint}/face/v1.0/persongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces/62004fa7-1ac0-478e-9d5a-b38f9e7fbc68

Sample Response

Status code:

200

Definitions

Name	Description
APIError	Error information returned by the API
Error	Error body.

APIError

Error information returned by the API

Name	Type	Description
error	Error	Error body.

Error

Error body.

Name	Type	Description
code	string
message	string