Update Brand Glossary
Updates a brand glossary. A field you omit is left untouched, a list you send replaces the existing list in full across all languages, and an empty array removes every entry. Read the glossary and preserve every entry’s pronunciation_language or target_language when sending an edited list; omitting a language field means all languages. A duplicate name or term/rule-type/language combination returns 409. A concurrent-edit conflict also returns 409 without saving the update; fetch the latest glossary and reapply your changes. Clients do not supply revisions. Tone settings are never modified by this endpoint. Temporary access-evaluation failures return 503; retry the request.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Path Parameters
Unique brand glossary identifier
Body
Request body for PATCH /v3/brand-glossaries/{brand_glossary_id}.
Each field is replaced independently: a field you omit is left untouched, a field you send replaces that value across all languages, and an empty array clears that list. To add a single entry, read the glossary, append to the list, and send the whole list back with every language field preserved.
New display name. Surrounding whitespace is removed, and the trimmed name must be 1-64 characters and unique within your workspace, compared without regard to case. Omit to keep the current name.
1 - 64Replacement term list across all languages. Preserve every entry's pronunciation_language when editing. Omit to leave the existing terms untouched, or pass an empty array to remove them all.
One glossary entry as accepted on POST / PATCH: a written term and how it should be spoken.
- BrandGlossaryTermWrite
- BrandGlossaryTermWrite
Replacement Don't Translate list. Omit to leave the existing entries untouched, or pass an empty array to remove them all.
Replacement Force Translate list across all languages. Preserve every entry's target_language when editing. Omit to leave the existing entries untouched, or pass an empty array to remove them all. Don't Translate takes precedence for overlapping terms without deleting their Force Translate rules.
Response
Successful response
A single brand glossary with its full term list (GET /v3/brand-glossaries/{id}).

