POST
/
v3
/
glossaries
Create a Glossary
curl --request POST \
  --url https://api.deepl.com/v3/glossaries \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "My Glossary",
  "dictionaries": [
    {
      "source_lang": "en",
      "target_lang": "de",
      "entries": "Hello\tGuten Tag",
      "entries_format": "tsv"
    },
    {
      "source_lang": "de",
      "target_lang": "en",
      "entries": "Guten Tag\tHello",
      "entries_format": "tsv"
    }
  ]
}'
{
  "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "name": "My Glossary",
  "dictionaries": [
    {
      "source_lang": "en",
      "target_lang": "de",
      "entry_count": 1
    }
  ],
  "creation_time": "2021-08-03T14:16:18.329Z"
}

Authorizations

​
Authorization
string
header
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Body

​
name
string
required

Name to be associated with the glossary.

Example:

"My Glossary"

​
dictionaries
object[]
required

Dictionaries to populate the glossary with.

Response

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.

​
glossary_id
string

A unique ID assigned to a glossary.

Example:

"def3a26b-3e84-45b3-84ae-0c0aaf3525f7"

​
name
string

Name associated with the glossary.

​
dictionaries
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).