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

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




## Servers
- DeepL API Pro: https://api.deepl.com (DeepL API Pro)
- DeepL API Free: https://api-free.deepl.com (DeepL API Free)


## Authentication methods
- Auth header


## Parameters

### Path parameters

- **glossary_id** (string)
  A unique ID assigned to the glossary.



### Body: application/json (object)
The dictionary to insert into (or overwrite in) the multilingual glossary.
- **source_lang** (string)
  The language in which the source texts in the glossary are specified.

- **target_lang** (string)
  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** (string)
  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](https://www.deepl.com/docs-api/glossaries/formats) for details about each format.



## Responses
### 200
JSON object containing the dictionary meta-information.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### Body: application/json (object)
- **source_lang** (string)
  The language in which the source texts in the glossary are specified.

- **target_lang** (string)
  The language in which the target texts in the glossary are specified.

- **entry_count** (integer)
  The number of entries in the glossary.


### 400
Bad request. Please check error message and your parameters.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### Body: application/json (object)
- **message** (string)
  Generic description of the error.

- **detail** (string)
  More specific description of the error.


### 401
Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 403
Forbidden. The access to the requested resource is denied, because of insufficient access rights.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 404
The requested resource could not be found.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 413
The request size exceeds the limit.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 429
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 456
Quota exceeded. The glossary creation limit has been reached.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 500
Internal error.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 503
Resource currently unavailable. Try again later.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


### 529
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.



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