Delete Faces
DELETE/v1/videos/{video_id}/faces
Delete specified faces from a video while ensuring at least one face remains.
People linked to a deleted face lose that link; a link to a speaker is kept. Repeated ids in one request count once.
Errors: 404 when a face id is not on the video (this includes a face that
was already deleted, so a retried delete can treat it as done); 409 with
detail last_face when the request would delete every face. Neither
changes anything.
Request
Responses
- 200
- 401
- 404
- 409
- 422
Successful Response
Missing, malformed or rejected credentials — no X-API-Key / Authorization: Bearer <jwt>, an expired token, or a caller that lacks the role the route requires. Note that this API answers authorization failures with 401 as well as 403 (see the 403 entry where a route declares both).
No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.
last_face: deleting these faces would leave the video with none. Nothing was deleted.
Validation Error