Face API Release Notes

This article pertains to Microsoft Face API Service version 1.0.

Release changes in May 2017

  • New Attribute Hair, makeup, accessories, occlusion, blur, exposure, and noise attributes could be returned from Face - Detect if hair, makeup, accessory, occlusion, blur, exposure or noise are specified in returnFaceAttributes.

  • Enhancement Support 10K persons in a person group, Face - Identify is also supported for the scale.

  • List Persons API Pagination is supported in Person - List Persons in a Person Group with extra optional parameters, start and top.

  • Enhancement Concurrency is supported in adding/deleting faces against different face lists or different persons in person group.

Release changes in March 2017

Release changes in November 2016

  • Face Storage Expansion; Face Storage allows a Standard subscription to store additional persisted faces when using Person objects (Person - Add A Person Face) or Face Lists (Face List - Add a Face to a Face List) for identification or similarity matching with the Face API. The stored images are charged at $0.5 per 1000 faces and this rate is prorated on a daily basis. Free tier subscriptions continue to be limited to 1,000 total persons.

Release changes in October 2016

Release changes in July 2016

  • Face Verification API: Face to Person object authentication is supported – previously Face Verification requests only supported Face to Face authentication. More details can be found here: Face - Verify.

  • Finding Similar Face API: Added optional mode field enabling selection of two working modes, default matchPerson works the same as before, and new mode matchFace removes the same person filtering. If mode field is not specified, the behavior is the same as the past release. More details can be found here: Face - Find Similar.

  • Face Identification API: Optional user-specified confidenceThreshold is enabled for user to define the confidence threshold of whether one face belongs to a person object. More details can be found here: Face - Identify.

  • List Person Groups: New optional start and top parameters in list person groups to support user specifying the start point and the total person groups number to list. More details can be found here: Person Group - List Person Groups.


All of these changes are compatible with the last version service, and using the default value for the newly added parameters will not cause any changes to users' code.

V1.0 changes from V0

  • API Signature: In Face API V1.0, Service root endpoint changes from https://westus.api.cognitive.microsoft.com/face/v0/ to https://westus.api.cognitive.microsoft.com/face/v1.0/. There are several signature changes for API, including:

  • Face Sizes: The previous version of Face API was not clear about the smallest face sizes the API could detect. With V1.0 the API correctly sets the minimal detectable size to 36x36 pixels. Faces smaller 36x36 pixels will not be detected.

  • Persisted Data: Existing Person Group and Person data which has been setup with Face V0 cannot be accessed with the Face V1.0 service. This incompatible issue will occur for only this one time, following API updates will not affect persisted data any more.


The V0 endpoint of Face API was retired on 06/30/2016.