people

Delete a person

Deletes the person record; the faces that were attached to this person are not deleted — they become unassigned and will be re-clustered on the next clustering pass.

Use update_face with person_id=null to detach a specific face without deleting the whole person. Use delete_face to remove a face detection entirely.

If a concurrent change to the person's faces collides with the deletion, it returns 409 and nothing is deleted; retry the request unchanged.

delete/api/people/{person_id}

Path parameters

person_idstring required

Person ID (with person_ prefix) of the person to delete.

Person ID (with person_ prefix) of the person to delete.

Response

Successful Response

DeletionResponse required

Empty acknowledgment returned when an operation succeeds.