> For the complete documentation index, see [llms.txt](https://doc.bodinat.de/doc/deepl/llms.txt)

# 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://doc.bodinat.de/doc/deepl/operation/operation-listglossarylanguages.md?server_id=server-https-api-free-deepl-com)

- [List all Glossaries](https://doc.bodinat.de/doc/deepl/operation/operation-listglossaries.md?server_id=server-https-api-free-deepl-com)

- [Create a Glossary](https://doc.bodinat.de/doc/deepl/operation/operation-createglossary.md?server_id=server-https-api-free-deepl-com)

- [Retrieve Glossary Details](https://doc.bodinat.de/doc/deepl/operation/operation-getglossary.md?server_id=server-https-api-free-deepl-com)

- [Delete a Glossary](https://doc.bodinat.de/doc/deepl/operation/operation-deleteglossary.md?server_id=server-https-api-free-deepl-com)

- [Retrieve Glossary Entries](https://doc.bodinat.de/doc/deepl/operation/operation-getglossaryentries.md?server_id=server-https-api-free-deepl-com)


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