OpenAPI spec for glossary management

This page contains only a set of guides that is auto-generated from DeepL's OpenAPI file.

For more detail about glossary management, including information about request parameters, please see the Manage glossaries entry.

List supported glossary languages

List Language Pairs Supported by Glossaries

Retrieve the list of language pairs supported by the glossary feature.

GEThttps://api.deepl.com/v2/glossary-language-pairs

Authorization

auth_header

Response

200400401403404413415429456500503529

A JSON object containing the language pairs in its supported_languages property.

Body

application/json

supported_languagesarray of object

The list of supported languages

Response

200400

{
  "supported_languages": [
    {
      "source_lang": "en",
      "target_lang": "de"
    }
  ]
}

Create a glossary

Create a Glossary

POSThttps://api.deepl.com/v2/glossaries

Authorization

auth_header

Body

application/jsonapplication/x-www-form-urlencoded

name*string

Name to be associated with the glossary.

Example: "My Glossary"

source_lang*GlossarySourceLanguage (enum)

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

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_lang*GlossaryTargetLanguage (enum)

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

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

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

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.

Example: "tsv"

tsvcsv

Response

201400401403404413415429456500503529

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.

Body

application/json

glossary_idGlossaryId (string)

A unique ID assigned to a glossary.

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

namestring

Name associated with the glossary.

readyboolean

Indicates if the newly created glossary can already be used in translate requests. If the created glossary is not yet ready, you have to wait and check the ready status of the glossary before using it in a translate request.

source_langGlossarySourceLanguage (enum)

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

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_langGlossaryTargetLanguage (enum)

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

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

creation_timestring (date-time)

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

entry_countinteger

The number of entries in the glossary.

Response

201400

{
  "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "ready": true,
  "name": "My Glossary",
  "source_lang": "en",
  "target_lang": "de",
  "creation_time": "2021-08-03T14:16:18.329Z",
  "entry_count": 1
}

List all glossaries

List all Glossaries

List all glossaries and their meta-information, but not the glossary entries.

GEThttps://api.deepl.com/v2/glossaries

Authorization

auth_header

Response

200400401403404413415429456500503529

JSON object containing a the glossaries.

Body

application/json

glossariesarray of Glossary (object)

Response

200400

{
  "glossaries": [
    {
      "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
      "ready": true,
      "name": "My Glossary",
      "source_lang": "en",
      "target_lang": "de",
      "creation_time": "2021-08-03T14:16:18.329Z",
      "entry_count": 1
    }
  ]
}

Retrieve glossary details

Retrieve Glossary Details

Retrieve meta information for a single glossary, omitting the glossary entries.

GEThttps://api.deepl.com/v2/glossaries/{glossary_id}

Authorization

auth_header

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Response

200400401403404413415429456500503529

JSON object containing the glossary meta-information.

Body

application/json

glossary_idGlossaryId (string)

A unique ID assigned to a glossary.

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

namestring

Name associated with the glossary.

readyboolean

Indicates if the newly created glossary can already be used in translate requests. If the created glossary is not yet ready, you have to wait and check the ready status of the glossary before using it in a translate request.

source_langGlossarySourceLanguage (enum)

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

Example: "en"

dadeenesfritjakonbnlplptrorusvzh

target_langGlossaryTargetLanguage (enum)

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

Example: "de"

dadeenesfritjakonbnlplptrorusvzh

creation_timestring (date-time)

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

entry_countinteger

The number of entries in the glossary.

Response

200400

{
  "glossary_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "ready": true,
  "name": "My Glossary",
  "source_lang": "en",
  "target_lang": "de",
  "creation_time": "2021-08-03T14:16:18.329Z",
  "entry_count": 1
}

Retrieve glossary entries

Retrieve Glossary Entries

List the entries of a single glossary in the format specified by the Accept header.

GEThttps://api.deepl.com/v2/glossaries/{glossary_id}/entries

Authorization

auth_header

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Header parameters

Response

200400401403404413415429456500503529

The entries in the requested format.

Body

text/tab-separated-values

any

Response

400

{
  "message": "text",
  "detail": "text"
}

Delete a glossary

Delete a Glossary

Deletes the specified glossary.

DELETEhttps://api.deepl.com/v2/glossaries/{glossary_id}

Authorization

auth_header

Path parameters

glossary_id*string

A unique ID assigned to the glossary.

Response

204400401403404413415429456500503529

Returns no content upon success.

Response

400

{
  "message": "text",
  "detail": "text"
}