# ManageGlossaries

Please note that this is the spec for the (old) v2 glossary endpoint.
We recommend users switch to the newer v3 glossary endpoints, which support editability and multilinguality.

The *glossary* functions allow you to create, inspect, and delete glossaries.
Glossaries created with the glossary function can be used in translate requests by specifying the
`glossary_id` parameter.
If you encounter issues, please let us know at support@DeepL.com.

Currently you can create glossaries with any of the languages DeepL supports.

The maximum size limit for a glossary is 10 MiB = 10485760 bytes and each source/target text,
as well as the name of the glossary, is limited to 1024 UTF-8 bytes.
A total of 1000 glossaries are allowed per account.

When creating a glossary with target language `EN`, `PT`, or `ZH`, it's not necessary to specify a variant
(e.g. `EN-US`, `EN-GB`, `PT-PT`, `PT-BR`, or `ZH-HANS`).
Glossaries with target language `EN` can be used in translations with either English variant.
Similarly `PT`, and `ZH` glossaries can be used in translations with their corresponding variants.

Note that on the v2 API, glossaries are immutable: once created, the glossary entries for a given glossary ID cannot be modified.

As a workaround for effectively editable glossaries, we suggest to identify glossaries by name instead of ID in your application
and then use the following procedure for modifications:
- [download](https://www.deepl.com/docs-api/glossaries/get-glossary-entries) and store the current glossary's entries,
- locally modify the glossary entries,
- [delete](https://www.deepl.com/docs-api/glossaries/delete-glossary) the existing glossary,
- [create a new glossary](https://www.deepl.com/docs-api/glossaries/create-glossary) with the same name.

## Operations

- [List Language Pairs Supported by Glossaries](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-listglossarylanguages.md?server_id=server-https-api-free-deepl-com)

- [List all Glossaries](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-listglossaries.md?server_id=server-https-api-free-deepl-com)

- [Create a Glossary](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-createglossary.md?server_id=server-https-api-free-deepl-com)

- [Retrieve Glossary Details](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-getglossary.md?server_id=server-https-api-free-deepl-com)

- [Delete a Glossary](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-deleteglossary.md?server_id=server-https-api-free-deepl-com)

- [Retrieve Glossary Entries](https://bump.sh/polo/hub/about-mcp/doc/deepl/operation/operation-getglossaryentries.md?server_id=server-https-api-free-deepl-com)


[Powered by Bump.sh](https://bump.sh)