Skip to main content
PATCH
Update Face
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 face identifier, e.g. r90bbd427f71.

Body

application/json
face_name
string

A new name for the face. Cannot be null or blank.

Example:

"Ana"

default_voice_id
string

The Voice this face speaks with when a PAL sets no voice of its own. Cannot be null or blank; a face with no default simply leaves nothing to resolve.

Example:

"v0a1b2c3d4e5f"

Response

face_id
string
Example:

"r90bbd427f71"

face_name
string
Example:

"Ana"

default_voice_id
string | null
Example:

"v0a1b2c3d4e5f"

original_voice_id
string | null

The voice this face was created with, read-only.

Example:

"v000000000001"