> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Glossary API is available

The [Glossary API](/reference/glossary/overview) provides create, read, update, and delete access to an AI Agent's glossary. A glossary term is a word or phrase the AI Agent should recognize in an end user's message. In `custom` mode, the AI Agent also restates the term using your preferred wording. Manage glossary terms through code and version control instead of only through the dashboard.

## API endpoints

Five REST endpoints are available:

* **List glossary terms** (`GET /v2/glossary/`): Returns the AI Agent's terms in cursor-paginated pages ordered by `id`.
* **Create a glossary term** (`POST /v2/glossary/`): Creates a term. The `external_id` is your own identifier for it and must be unique within the AI Agent.
* **Get a glossary term** (`GET /v2/glossary/{glossary_term_id}`): Returns a single term by its `id`.
* **Update a glossary term** (`PATCH /v2/glossary/{glossary_term_id}`): Partially updates a term; only the fields in the request body change.
* **Delete a glossary term** (`DELETE /v2/glossary/{glossary_term_id}`): Permanently deletes a term, along with any availability rule attached to it.

Each term can carry an `availability_rules` rule that gates when it applies. Set `voice_detection_enabled` to help the voice agent recognize the term in speech. Set `voice_pronunciations` to control how the AI Agent says the term on a voice call.

## Get started

Read the full reference for fields, limits, and authentication.

* [Glossary API reference](/reference/glossary/overview) for fields, translation modes, limits, pagination, and authentication.