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.

Authentication: API Key Category: Translation & Content Availability: All workspace plans

Available Actions

Translate Text

deepl.translateText
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 glossaryId. 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:

  • translations: Array of translation objects containing:

    • detected_source_language: Detected source language code

    • text: Translated text

  • usage: Usage information including character count


Improve Text

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

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 entriesFormat parameter. Example: Hello Guten Tag

  • entriesFormat (TEXT, Required): The format in which the glossary entries are provided. Formats currently available: tsv (default) - tab-separated values, csv - comma-separated values

Output:

  • Returns the created glossary with its ID and metadata


List All Glossaries

Lists all available glossaries.

Requires Confirmation: No

Parameters: None

Output:

  • Returns an array of glossaries with their IDs, names, and language pairs


Delete Glossary

Deletes a glossary specified by id.

Requires Confirmation: Yes

Parameters:

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

Output:

  • Returns confirmation of deletion


Get Glossary

Retrieves meta information or entries of a 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 glossary's entries / content

Output:

  • Returns glossary information including name, language pair, and optionally entries


Get Usage

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

  • Data Management — Manage and organize your DeepL data

  • Automation — Automate workflows with DeepL

  • Reporting — Generate insights and reports

  • Integration — Connect DeepL with other tools

Best Practices

Getting Started:

1

Enable the integration

Enable the DeepL integration in your workspace settings.

2

Authenticate

Authenticate using API Key.

3

Test connection

Test the connection with a simple read operation.

4

Explore actions

Explore available actions for your use case.

Important Considerations:

  • Ensure proper authentication credentials

  • Respect rate limits and API quotas

  • Review data privacy settings

  • Test operations in a safe environment first

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 [email protected]envelope