---
title: "Replaces or creates a dictionary in the glossary with the specified entries."
method: PUT
path: "/v3/glossaries/{glossary_id}/dictionaries"
tags: ["ManageMultilingualGlossaries"]
---

# Replaces or creates a dictionary in the glossary with the specified entries.

`PUT /v3/glossaries/{glossary_id}/dictionaries`

## Path parameters

- `glossary_id` string, required

## Request body

- MultilingualGlossaryEntries
  - `source_lang` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'et' | 'fi' | 'fr' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'lv' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' — The language in which the source texts in the glossary are specified.
  - `target_lang` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'et' | 'fi' | 'fr' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'lv' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' — The language in which the target texts in the glossary are specified.
  - `entries` string — The entries of the glossary. The entries have to be specified in the format provided by the `entries_format` parameter.
  - `entries_format` 'tsv' | 'csv' — The format in which the glossary entries are provided. Formats currently available: - `tsv` (default) - tab-separated values - `csv` - comma-separated values See [Supported Glossary Formats](/docs/customize/managing-glossaries#entry-formats) for details about each format.

## Response `200`

JSON object containing the dictionary meta-information.

- MultilingualGlossaryEntriesInformation
  - `source_lang` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'et' | 'fi' | 'fr' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'lv' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' — The language in which the source texts in the glossary are specified.
  - `target_lang` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'et' | 'fi' | 'fr' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'lv' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' — The language in which the target texts in the glossary are specified.
  - `entry_count` integer — The number of entries in the glossary.

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `401` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403` — Forbidden. The access to the requested resource is denied, because of insufficient access rights. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.
- `404` — The requested resource could not be found.
- `413` — The request size exceeds the limit.
- `415` — The requested entries format specified in the `Accept` header is not supported.
- `429` — Too many requests. Please wait and resend your request.
- `456` — Quota exceeded. Too many requests were made to the glossary endpoints recently.
- `500` — Internal error.
- `503` — Resource currently unavailable. Try again later.
- `529` — Too many requests. Please wait and resend your request.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)