---
title: "Update Brand Voice"
method: POST
path: "/v1/brand_voice/{brand_voice_id}"
tags: ["Voices"]
---

# Update Brand Voice

`POST /v1/brand_voice/{brand_voice_id}`

Updates an existing brand voice with specified changes. Only the fields that need to be modified should be included in the request body.

## Path parameters

- `brand_voice_id` string, required

## Request body

- object
  - `name` string — New name for the brand voice
  - `blacklist` string[] — List of words that should not be translated (e.g., brand names, person names)
  - `whitelist` string[] — List of word pairs for forced translations | [["AI", "artificial intelligence"]]
  - `tones` string[] — List of tone keywords to influence the voice
  - `vocabulary` string[] — List of word pairs for pronunciation guidance
  - `tone` string — Overall tone description

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/heygen/apis/heygen-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-api/revisions/2f19176d6d56/schema)