---
title: "Delete Faces"
method: DELETE
path: "/v1/videos/{video_id}/faces"
tags: ["Video Emotion API"]
---

# Delete Faces

`DELETE /v1/videos/{video_id}/faces`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v1/videos/{video_id}/faces`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

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.

## Path parameters

- `video_id` string, required: The unique identifier of the video from which faces will be deleted.

## Request body `application/x-www-form-urlencoded`

- BodyDeleteFacesV1VideosVideoIdFacesDelete
  - `face_ids` string, required: Comma-separated list of face IDs to delete (e.g., 1,2,3)

## Response `200`

Successful Response

- DeleteFacesResponse: Response model after deleting one or more faces. Attributes: id (str): Video or frame ID the faces belonged to. message (str): Confirmation or error message.
  - `id` string, required
  - `message` string, required

## Other responses

- `401`: 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).
- `404`: 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.
- `409`: `last_face`: deleting these faces would leave the video with none. Nothing was deleted.
- `422`: Validation Error

## Changes

- **2026-10-01** `72330e2229c7`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v1/videos/:video_id/faces/delete.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)