Skip to main content
DELETE
/
v2
/
faces
/
{face_id}
Delete Face
curl --request DELETE \
  --url https://tavusapi.com/v2/faces/{face_id} \
  --header 'x-api-key: <api-key>'
{
  "error": "Invalid face_id"
}
For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
face_id
string
required

The unique identifier of the face.

Example:

"r90bbd427f71"

Query Parameters

​
hard
boolean

If set to true, the face and associated assets (such as training footage) will be hard deleted. CAUTION: This action is irrevocable. Note that a hard delete of a face does not delete the conversation created using said face. See Delete Video for more info.

Example:

false

Response

OK