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

# Create a Glossary

> POST /v3/glossaries



## 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



### Body: application/json (object)

- **name** (string)
  Name to be associated with the glossary.

- **dictionaries** (array[object])
  Dictionaries to populate the glossary with.



## Responses
### 201
The function for creating a glossary returns a JSON object containing the ID of the newly created glossary and a boolean flag that indicates if the created glossary can already be used in translate requests.
#### Headers

- **X-Trace-ID** ()


#### Body: application/json (object)
- **glossary_id** (string)
  A unique ID assigned to a glossary.

- **name** (string)
  Name associated with the glossary.

- **dictionaries** (array[object])
  List of dictionaries contained in this glossary.
  Each dictionary contains a source and target language, as well as pairs of source and target entries.

- **creation_time** (string(date-time))
  The creation time of the glossary in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`).


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

- **X-Trace-ID** ()


#### 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** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()


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

- **X-Trace-ID** ()



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