Skip to main content
PUT
/
v3
/
glossaries
/
{glossary_id}
/
dictionaries
Replaces or creates a dictionary in the glossary with the specified entries.
curl --request PUT \
  --url https://api.deepl.com/v3/glossaries/{glossary_id}/dictionaries \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_lang": "en",
  "target_lang": "de",
  "entries": "Hello\tGuten Tag",
  "entries_format": "tsv"
}
'
{
  "source_lang": "en",
  "target_lang": "de",
  "entry_count": 123
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
glossary_id
string
required

A unique ID assigned to the glossary.

Body

application/json

The dictionary to insert into (or overwrite in) the multilingual glossary.

​
source_lang
enum<string>

The language in which the source texts in the glossary are specified.

Available options:
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
Example:

"en"

​
target_lang
enum<string>

The language in which the target texts in the glossary are specified.

Available options:
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
Example:

"de"

​
entries
string

The entries of the glossary. The entries have to be specified in the format provided by the entries_format parameter.

Example:

"Hello\tGuten Tag"

​
entries_format
enum<string>
default:tsv

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 for details about each format.

Available options:
tsv,
csv
Example:

"tsv"

Response

JSON object containing the dictionary meta-information.

​
source_lang
enum<string>

The language in which the source texts in the glossary are specified.

Available options:
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
Example:

"en"

​
target_lang
enum<string>

The language in which the target texts in the glossary are specified.

Available options:
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
Example:

"de"

​
entry_count
integer

The number of entries in the glossary.