> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply a Glossary

> Pass a brand_glossary_id on HeyGen videos, templates, Video Agent sessions, batches, and video translations so your terms are spoken and translated your way.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=3e4c2594813dcfd56985f3d63e3ba321)

Pass `brand_glossary_id` at the top level of the request, one glossary per call:

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/videos" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "avatar",
    "brand_glossary_id": "8c2d5e91a47b4f3c8d1e6a9b2f5c7d40",
    "avatar_id": "YOUR_AVATAR_ID",
    "engine": { "type": "heygen-avatar-6" },
    "script": "HeyGen shipped this in 2024.",
    "voice_id": "YOUR_VOICE_ID"
  }'
```

Video generation (`studio`, `avatar` and `image` videos, [video batches](https://heygen-1fa696a7.mintlify.site/reference/create-video-batch.md) per item, [templates](https://heygen-1fa696a7.mintlify.site/reference/generate-video-from-template.md) and [Video Agent](https://heygen-1fa696a7.mintlify.site/reference/create-video-agent-session.md), set once per session) applies its [pronunciations](https://heygen-1fa696a7.mintlify.site/docs/brand-glossary/pronunciations.md). [Video translation](https://heygen-1fa696a7.mintlify.site/reference/create-video-translation.md), its [batches](https://heygen-1fa696a7.mintlify.site/batch-video-translations.md) per item, and [proofreads](https://heygen-1fa696a7.mintlify.site/reference/create-proofread-session.md) apply its [translation rules](https://heygen-1fa696a7.mintlify.site/docs/brand-glossary/translation-rules.md). Pronunciations apply where speech is synthesized from a `script`; your own `audio_url` or `audio_asset_id` plays as recorded. Video batch items are `avatar` or `image`. Glossary IDs are 32-character hex strings scoped to the workspace that owns them; an unknown ID fails with `400` before rendering, so no credits are spent. To shape how the video looks, pair the glossary with a [brand kit](https://heygen-1fa696a7.mintlify.site/docs/brand-kits.md) on Video Agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.