DeepL

​

Overview

Advanced AI translation service delivering accurate, natural-sounding translations. Through Langdock’s integration, you can access and manage DeepL directly from your conversations.

​

Available Actions

​

Translate Text

deepl.translateText

Translates text from one language to another using DeepL’s translation service Requires Confirmation: No Parameters:

• inputText (MULTI_LINE_TEXT, Required): The text to translate
  • targetLanguage (SELECT, Required): The Target Language. Options include: English (US), French, German, Italian, Spanish, Japanese, Dutch, Polish, Turkish, Russian, Chinese, Danish, Portuguese (Brazil), Korean, Indonesian, Hungarian, Czech, Greek, Bulgarian, Estonian, Lithuanian, Norwegian Bokmal, Latvian, Romanian, Slovak, Slovenian, Swedish, Ukrainian, Chinese (Simplified), Chinese (Traditional), Portuguese (Portugal)
  • sourceLanguage (SELECT, Optional): The source language of the text. If not specified, DeepL will auto-detect the language. Required when using glossary id. Options include: Arabic, Bulgarian, Czech, Danish, German, Greek, English, Spanish, Estonian, Finnish, French, Hungarian, Indonesian, Italian, Japanese, Korean, Lithuanian, Latvian, Norwegian Bokmal, Dutch, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Swedish, Turkish, Ukrainian, Chinese
  • glossaryId (TEXT, Optional): The unique identifier of the glossary to use for translation. Requires source language to be set. The glossary language pair must match the translation language pair
  • formality (SELECT, Optional): Sets the formality level of the translation. Available for target languages DE, FR, IT, ES, NL, PL, PT-BR, PT-PT, JA, and RU. Use prefer_ options to fallback gracefully for unsupported languages. Options: default, more, less, prefer_more, prefer_less

Output: Returns translation results with the following structure:

• translations: Array of translation objects containing:
  • detected_source_language: Detected source language code
  • text: Translated text
• usage: Usage information including character count

---

​

Improve Text

deepl.improveText

Improves and rephrases text in the specified target language with optional writing style or tone but not both Requires Confirmation: No Parameters:

• inputText (MULTI_LINE_TEXT, Required): The text to translate
  • targetLanguage (SELECT, Optional): The Target Language. Options: French, German, Italian, Spanish, Portuguese (Brazil), Portuguese (Portugal), English, English (UK), English (US)
  • writingStyle (SELECT, Optional): Specify a style to rephrase your text in a way that fits your audience and goals. The prefer_ prefix allows falling back to the default tone if the language does not yet support tones. Options: academic, business, casual, default, simple, prefer_academic, prefer_business, prefer_casual, prefer_simple
  • tone (SELECT, Optional): Specify the desired tone for your text. The prefer_ prefix allows falling back to the default tone if the language does not yet support tones. Options: confident, default, diplomatic, enthusiastic, friendly, prefer_confident, prefer_diplomatic, prefer_enthusiastic

Output: Returns improved text with the same structure as translation results

---

​

Create Glossary

deepl.createGlossary

Creates a glossary Requires Confirmation: Yes Parameters:

• name (TEXT, Required): The name of the glossary you want to create
  • sourceLanguage (TEXT, Required): The language in which the source texts in the glossary are specified. Example: en. Available options: da de en es fr it ja ko nb nl pl pt ro ru sv zh
  • targetLanguage (TEXT, Required): The language in which the target texts in the glossary are specified. Example: en. Available options: da de en es fr it ja ko nb nl pl pt ro ru sv zh
  • entries (TEXT, Required): The entries of the glossary. The entries have to be specified in the format provided by the entries_format parameter. Example: ‘Hello Guten Tag’
  • entriesFormat (TEXT, Required): The format in which the glossary entries are provided. Formats currently available: 1. tsv (default) - tab-separated values, 2. csv - comma-separated values

Output: Returns the created glossary with its ID and metadata

---

​

List All Glossaries

deepl.listAllGlossaries

Lists all available glossaries Requires Confirmation: No Parameters: None Output: Returns an array of glossaries with their IDs, names, and language pairs

---

​

Delete Glossary

deepl.deleteGlossary

Deletes a by id specified glossary Requires Confirmation: Yes Parameters:

• glossaryId (TEXT, Required): The unique identifier of the glossary you want to retrieve information about

Output: Returns confirmation of deletion

---

​

Get Glossary

deepl.getGlossary

Retrieves meta information or entries of an single glossary specified by its id Requires Confirmation: No Parameters:

• glossaryId (TEXT, Required): The unique identifier of the glossary you want to retrieve information about
  • entries (BOOLEAN, Optional): if checked it will retrieve the glossarys entries / content

Output: Returns glossary information including name, language pair, and optionally entries

---

​

Get Usage

deepl.getUsage

Retrieves current usage information for your DeepL API account including character counts and limits Requires Confirmation: No Parameters: None Output: Returns usage information including character count and limits

---

​

Common Use Cases

​

Best Practices

​

Troubleshooting

Issue	Solution
Authentication failed	Verify your API Key credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

​

Support

For additional help with the DeepL integration, contact support@langdock.com