Skip to main content

FaceApi

MethodHTTP requestDescription
create_face_using_postPOST /api/web/v1/users/{userid}/faceCreate a Face Biometric for a user
delete_face_using_deleteDELETE /api/web/v1/face/{faceid}Delete the Face Biometric by a given ID
get_faces_using_getGET /api/web/v1/users/{userid}/facesGet the Face Biometrics for a given user
get_user_face_settings_using_getGET /api/web/v1/users/{userid}/settings/faceGets a user Face Biometric settings
update_face_using_putPUT /api/web/v1/users/{userid}/faceUpdate the Face Biometric for a given user

create_face_using_post

FaceAuthenticator create_face_using_post(userid, face_create_parms)

Create a Face Biometric for a user

Create a Face for the specified user. Caller requires the FACE:ADD permission.

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstr
face_create_parmsFaceCreateParms

Return type

FaceAuthenticator

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

delete_face_using_delete

delete_face_using_delete(faceid)

Delete the Face Biometric by a given ID

Delete the Face Biometric by the specified ID. Caller requires the FACE:REMOVE permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
faceidstrThe ID of the Face Biometric.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

get_faces_using_get

List[FaceAuthenticator] get_faces_using_get(userid)

Get the Face Biometrics for a given user

Get the Face Biometrics for the specified user. Caller requires the FACE:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user to get the Face Biometrics for.

Return type

List[FaceAuthenticator]

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

get_user_face_settings_using_get

UserFaceSettings get_user_face_settings_using_get(userid)

Gets a user Face Biometric settings

Get Face Biometric settings information for the specified user. Caller requires the FACE:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose Face Biometric settings information is to be fetched.

Return type

UserFaceSettings

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

update_face_using_put

update_face_using_put(userid, face_update_parms)

Update the Face Biometric for a given user

Update the Face Biometric for the specified user. Caller requires the FACE:EDIT permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user to update the Face Biometric for.
face_update_parmsFaceUpdateParms

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-