Update Face Information

Last Updated on : 2023-06-15 05:23:44

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 nameTypeINRequiredDescription
device_idStringuritrueThe ID of a Tuya device.
person_idStringuritrueThe ID of a specified user.
face_idStringuritrueThe face ID.

Description of body

Parameter nameTypeINRequiredDescription
urlString trueThe URL of the face image.
device_idStringuritrueThe ID of a Tuya device.
person_idStringuritrueThe ID of a specified user.
face_idStringuritrueThe face ID.

Return parameter

Parameter nameTypeDescription
resultCmdIssueResultResponseThe returned result.

Description of result

Parameter nameTypeDescription
snStringThe 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.