Cloud Services API ReferenceAdvanced Device ServicesExtension APIsThird-Party Industry Device CapabilitiesSmart Access Control ServiceSmart Access Face ManagementUpdate Face Information

Update Face Information

Last Updated on : 2023-06-20 14:54:12download

Send an updating command to a specified access control device to update the information about a specified face. The maximum number of requests per second (QPS) for a single account to call this API is 5.

API address

PUT: /v1.0/access-control/{device_id}/persons/{person_id}/faces/{face_id}

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	The ID of a Tuya device.
person_id	String	uri	true	The ID of a specified user.
face_id	String	uri	true	The face ID.

Description of body

Parameter name	Type	IN	Required	Description
url	String		true	The URL of the face image.
device_id	String	uri	true	The ID of a Tuya device.
person_id	String	uri	true	The ID of a specified user.
face_id	String	uri	true	The face ID.

Return parameter

Parameter name	Type	Description
result	CmdIssueResultResponse	The returned result.

Description of result

Parameter name	Type	Description
sn	String	The ID of a specified command record.

Request example

PUT: /v1.0/access-control/6ce****/persons/123****/faces/faceId****

{
  "url": "http://****.jpg"
}

Return example

{
    "result": {
        "sn": "133****"
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.

Prev DocDelete Face

Next DocSmart Access QR Code Management