Bulk Delete Faces

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

Send a deletion command to a specified access control device to delete the specified users' faces in bulk.

API address

DELETE: /v1.0/access-control/{device_id}/persons/faces

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe ID of a Tuya device.

Description of body

Parameter nameTypeINRequiredDescription
face_del_listList trueThe list of faces to be deleted in bulk.

Description of face_del_list

Parameter nameTypeINRequiredDescription
person_idString trueThe ID of a specified user.
face_idString trueThe face ID.

Return parameter

Parameter nameTypeDescription
resultCmdIssueBatchResultResponseThe returned result.

Description of result

Parameter nameTypeDescription
sn_listListThe command record ID.

Request example

DELETE: /v1.0/access-control/6ce****/persons/faces
{
  "face_del_list": [
    {
      "person_id": "123****",
      "face_id": "faceID****"
    },
    {
      "person_id": "123****",
      "face_id": "faceId****"
    }
  ]
}

Return example

{
    "result": {
        "sn_list": [
            "133****",
            "132****"
        ]
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.