OpenAPI 3.1.0raw.githubusercontent.com2026-08-106577346.8 KB

f95c30b0b4e6

faces

Delete a face detection

Removes one face detection row; the underlying asset and the person this face was assigned to are both preserved.

Use update_face with person_id=null instead when the user wants to disassociate the face from a person without discarding the detection (so re-clustering can try again). Use delete_person to remove a person; use trash_assets to remove the photo entirely.

delete/api/faces/{face_id}

Path parameters

face_idstring required

Face ID (with face_ prefix) of the face detection to delete.

Face ID (with face_ prefix) of the face detection to delete.

Query parameters

library_idstring nullable

Library the face belongs to. Optional if the user has a single live (non-trashed) library; required when they have multiple.

Library the face belongs to. Optional if the user has a single live (non-trashed) library; required when they have multiple.

Response

Successful Response

DeletionResponse required

Empty acknowledgment returned when an operation succeeds.