Create a Glossary | Deepl API documentation

Create a Glossary Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Deepl MCP server": {
    "url": "https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp"
  }
}

POST /v3/glossaries

Auth header

Body Required

name string Required

Name to be associated with the glossary.
dictionaries array[object] Required

Dictionaries to populate the glossary with.
Hide dictionaries attributes Show dictionaries attributes object
A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.
- source_lang string
  
  The language in which the source texts in the glossary are specified.
  
  Values are 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, or zh.
- target_lang string
  
  The language in which the target texts in the glossary are specified.
  
  Values are 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, or zh.
- 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 for details about each format.
  Values are tsv or csv. Default value is tsv.

Body Required

name string Required

Name to be associated with the glossary.
dictionaries array[object] Required

Dictionaries to populate the glossary with.
Hide dictionaries attributes Show dictionaries attributes object
A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.
- source_lang string
  
  The language in which the source texts in the glossary are specified.
  
  Values are 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, or zh.
- target_lang string
  
  The language in which the target texts in the glossary are specified.
  
  Values are 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, or zh.
- 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 for details about each format.
  Values are tsv or csv. Default value is tsv.

Responses

201 application/json

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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
Hide response attributes Show response attributes 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.
  
  Hide dictionaries attributes Show dictionaries attributes object
  
  A dictionary contained in a multilingual glossary. Each dictionary contains the mapping of source terms to target language terms.
  
  source_lang string
  
  The language in which the source texts in the glossary are specified.
  
  Values are 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, or zh.
  
  target_lang string
  
  The language in which the target texts in the glossary are specified.
  
  Values are 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, or zh.
  
  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 for details about each format.
  
  Values are tsv or csv. Default value is tsv.
- 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 application/json

Bad request. Please check error message and your parameters.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
Hide response attributes Show response attributes 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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
403

Authorization failed. Please supply a valid DeepL-Auth-Key via the Authorization header.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
500

Internal error.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.

POST /v3/glossaries

curl \
 --request POST '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"}]}'

curl \
 --request POST 'https://api.deepl.com/v3/glossaries' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'name=My+Glossary&dictionaries=%7B%22source_lang%22+%3D%3E+%22en%22%2C+%22target_lang%22+%3D%3E+%22de%22%2C+%22entries%22+%3D%3E+%22Hello%5CtGuten+Tag%22%2C+%22entries_format%22+%3D%3E+%22tsv%22%7D'

Request example

{
  "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"
    }
  ]
}

Response examples (201)

# Headers

# Payload
{
  "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"
}

Response examples (400)

{
  "message": "Invalid glossary entries provided",
  "detail": "Key with the index 1 (starting at position 13) duplicates key with the index 0 (starting at position 0)"
}