---
title: "Update Face"
method: PATCH
path: "/v2/faces/{face_id}"
tags: ["Faces"]
---

# Update Face

`PATCH /v2/faces/{face_id}`

## Request

- Base URL: `https://tavusapi.com`
- URL: `https://tavusapi.com/v2/faces/{face_id}`
- Auth: API key in header `x-api-key`

JSON Merge Patch on the face. Send `face_name`, `default_voice_id`, or both.

Use this to change which [Voice](/sections/conversational-video-interface/voices) a face speaks with after it has been created. `original_voice_id` is read-only, so setting `default_voice_id` back to it reverts the face to the voice it started with.

<Note>
`PATCH /v2/faces/{face_id}/name` is a legacy route that renames a face and nothing else. It still works, so existing integrations are unaffected, but this endpoint replaces it and can change the name and the default voice in one call.
</Note>

## Path parameters

- `face_id` string, required

## Request body

- object
  - `face_name` string: A new name for the face. Cannot be null or blank.
  - `default_voice_id` string: The [Voice](/sections/conversational-video-interface/voices) 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.

## Response `200`

- object
  - `face_id` string
  - `face_name` string
  - `default_voice_id` string, nullable
  - `original_voice_id` string, nullable: The voice this face was created with, read-only.

## Other responses

- `400`: BAD REQUEST
- `401`: UNAUTHORIZED

## Changes

- **2026-11-03** `932c24e63be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/faces/:face_id/patch.md)

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) - [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/revisions/932c24e63be2?raw)