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.
Path parameters
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 the face belongs to. Optional if the user has a single library; required when they have multiple.
Library the face belongs to. Optional if the user has a single library; required when they have multiple.
Response
Successful Response
Acknowledgment body returned by destructive endpoints (delete / trash / restore / permanently delete / remove-from-album / empty-trash).
Carries no fields — the HTTP 200 + empty JSON object is itself the success signal. Exists so MCP tools generated from these endpoints have a real outputSchema (rather than the null schema FastMCP emits for 204 responses), which ChatGPT's MCP submission tooling requires.