# DeepL Documentation

## Docs

- [Admin API](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api.md): Explore DeepL API offering designed for admins
- [Get usage analytics](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/get-usage-analytics.md): Retrieve usage statistics for the organization within a specified date range. Optionally group the results by API key or by API key and day.
- [Managing admin API keys](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-admin-keys.md): Learn how admins can create and manage admin API keys.
- [Managing developer API keys](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys.md): Learn how admins can create and manage developer API keys.
- [Create a developer key](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys/create-key.md)
- [Deactivate a developer key](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys/deactivate-key.md)
- [Get developer keys](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys/get-keys.md)
- [Rename a developer key](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys/rename-key.md)
- [Set developer key limits](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/managing-developer-keys/set-usage-limits.md)
- [Accessing organization usage analytics](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/admin-api/organization-usage-analytics.md): Learn how admins can retrieve and analyze usage data across their organization.
- [DeepL Agent API](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/agent-api.md): API reference to trigger DeepL Agent workflows and retrieve task results.
- [Get task results](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/agent-api/get-task-result.md): Retrieves the current status and result of a previously triggered workflow task. Use this endpoint to poll for task completion after triggering a workflow.
- [Trigger workflow](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/agent-api/trigger-workflow.md): Triggers an agentic workflow with the specified ID. The workflow will be executed asynchronously, and a task ID will be returned to poll for status updates.
- [Translate documents](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/document.md)
- [Check document status](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/document/check-document-status.md)
- [Download translated document](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/document/download-translated-document.md)
- [Upload and translate a document](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/document/upload-and-translate-a-document.md)
- [Monolingual glossaries (v2 endpoints)](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries.md): Manage glossaries using the v2 endpoints
- [Create a glossary](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/create-a-glossary.md)
- [Delete a glossary](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/delete-a-glossary.md): Deletes the specified glossary.
- [List all glossaries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/list-all-glossaries.md): List all glossaries and their meta-information, but not the glossary entries.
- [Retrieve glossary details](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/retrieve-glossary-details.md): Retrieve meta information for a single glossary, omitting the glossary entries.
- [Retrieve glossary entries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/retrieve-glossary-entries.md): List the entries of a single glossary in the format specified by the `Accept` header.
- [v2 vs v3 endpoints](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/glossaries/v2-vs-v3-endpoints.md)
- [Improve text](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/improve-text.md)
- [Request text improvement](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/improve-text/request-text-improvement.md)
- [Retrieve languages](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/languages.md): API reference for retrieving supported languages with the DeepL API.
- [Retrieve supported languages](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/languages/retrieve-supported-languages.md)
- [Glossaries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries.md): Manage and use DeepL glossaries
- [Create a glossary](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/create-a-glossary.md)
- [Delete a glossary](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/delete-a-glossary.md): Deletes the specified glossary.
- [Deletes the dictionary associated with the given language pair with the given glossary ID.](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/deletes-the-dictionary-associated-with-the-given-language-pair-with-the-given-glossary-id.md)
- [Edit glossary details](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/edit-glossary-details.md): Edit glossary details, such as name or a dictionary for a source and target language.
- [List all glossaries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/list-all-glossaries.md): List all glossaries and their meta-information, but not the glossary entries.
- [List language pairs supported for glossaries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries.md): Retrieve the list of language pairs supported by the glossary feature.
- [Replaces or creates a dictionary in the glossary with the specified entries.](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/replaces-or-creates-a-dictionary-in-the-glossary-with-the-specified-entries.md)
- [Retrieve glossary details](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/retrieve-glossary-details.md): Retrieve meta information for a single glossary, omitting the glossary entries.
- [Retrieve glossary entries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/multilingual-glossaries/retrieve-glossary-entries.md): List the entries of a single glossary in tsv format.
- [Style rules](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/style-rules.md): Manage a shared list of rules for style, formatting, and more
- [Get all style rule lists](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/style-rules/list-all-style-rules.md)
- [Translate Text](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/translate.md): API reference for translating text with the DeepL API.
- [Translate text](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/translate/request-translation.md)
- [Retrieve usage and quota](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/usage-and-quota.md): API reference for retrieving usage and quota for the current billing period with the DeepL API.
- [Check usage and limits](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/usage-and-quota/check-usage-and-limits.md)
- [Translate Speech in Realtime](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/voice.md): API reference for real-time voice transcription and translation with the DeepL Voice API.
- [Reconnect Session](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/voice/reconnect-session.md)
- [Request Session](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/voice/request-session.md)
- [WebSocket Streaming](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/voice/websocket-streaming.md)
- [CORS requests](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/cors-requests.md)
- [Subscription-level cost control](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/cost-control.md)
- [Custom instructions](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/custom-instructions.md): Learn how to create effective custom instructions to customize your translation behavior
- [Document translations](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/document-translations.md)
- [Error handling](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/error-handling.md)
- [Language detection](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/language-detection.md)
- [Pre-production checklist](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/best-practices/pre-production-checklist.md): Here's what we recommend reviewing to get your DeepL API application ready for production.
- [About](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/about.md)
- [Access and authentication](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/auth.md): Learn where to find your authentication key and how to access the DeepL API.
- [Client libraries](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/client-libraries.md)
- [Introduction](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/intro.md): Welcome to the developer home of DeepL API.
- [Managing API keys](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/managing-api-keys.md): A guide to creating API keys, getting API key-level usage, and setting API key-level limits.
- [Regional API Endpoints](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/regional-endpoints.md): Reference documentation for DeepL's regional API endpoints, including endpoint URLs, configuration, and technical specifications.
- [Languages supported](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/supported-languages.md): The DeepL API supports the following languages.
- [Test your API requests with Postman](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/test-your-api-requests-with-postman.md): Use our official Postman collection to get familiar with and test the DeepL API.
- [Your first API request](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/getting-started/your-first-api-request.md): Make your first API requests to translate and improve text with the DeepL API.
- [Cookbook](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook.md): A collection of short tutorials, examples, and projects using the DeepL API and Client Libraries.
- [Automating Indie Game Localization with the DeepL API and Godot](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook/automating-indie-game-localization-with-the-deepl-api-and-godot.md): Efficiently translate content for a global audience and widen your game's reach
- [Project: Google Sheets](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook/google-sheets.md): Open-source example showing how to build a Google Sheets App using the DeepL API.
- [Building a Document Translator with the DeepL API](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook/java-document-translator.md): Streamline document localization workflows with automated translation for businesses and developers
- [Making API calls from client-side JavaScript](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook/nodejs-proxy.md): Two lightweight local proxies that let you try the DeepL API directly from a website
- [Usage Analytics Dashboard](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/cookbook/usage-analytics-dashboard.md): A demo dashboard for visualizing DeepL API key usage across an entire account using the Admin API.
- [DeepL MCP Server: How to build and use translation in LLM applications](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications.md): Efficiently translate content with AI-powered translation and enhance your interactions with large language models.
- [First Things To Try With The DeepL API](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/first-things-to-try-with-the-deepl-api.md): New around here? We've got you covered
- [Glossaries in the real world](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/glossaries-in-the-real-world.md): A quick guide to using DeepL glossaries in translations
- [How to Use the Context Parameter Effectively](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter.md): Learn when and how to use the context parameter to improve translation accuracy for ambiguous content.
- [Mustache placeholder tags](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/placeholder-tags.md): An example for working with placeholder tags—in this case, Mustache tags.
- [How to Translate Between Language Variants](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/learning-how-tos/examples-and-guides/translating-between-variants.md): Learn how to translate between language variants, like British English and US English, using the DeepL API.
- [Alpha and beta features](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/alpha-and-beta-features.md): Learn more about alpha and beta features in the DeepL API and how to best make use of them.
- [Breaking changes (Change Notices)](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/breaking-changes-change-notices.md)
- [July 2024: Deprecation of insecure cipher suites](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/breaking-changes-change-notices/july-2024-deprecation-of-insecure-cipher-suites.md)
- [March 2025: Deprecating GET requests to /translate and authenticating with auth_key](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/breaking-changes-change-notices/march-2025-deprecating-get-requests-to-translate-and-authenticating-with-auth_key.md)
- [November 2025: Deprecation of query parameter and request body authentication](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods.md)
- [Developer Community](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/deepl-developer-community.md)
- [Language release process](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/language-release-process.md): Here's what API users can expect when DeepL adds translation support for a new language or language variant.
- [Open API spec](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/open-api-spec.md)
- [Roadmap and release notes](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/roadmap-and-release-notes.md): The latest features and improvements in the DeepL API, plus what's coming next
- [Usage and limits](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/resources/usage-limits.md)
- [Customized XML outline detection](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/xml-and-html-handling/customized-xml-outline-detection.md): Learn how to customize XML outline detection with the DeepL API.
- [HTML handling](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/xml-and-html-handling/html.md): Learn how to translate HTML content with the DeepL API.
- [Structured XML content](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/xml-and-html-handling/structured-content.md): Learn how to work with structured XML content with the DeepL API.
- [New: XML/HTML handling v2](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/xml-and-html-handling/tag-handling-v2.md): Learn about the benefits of tag handling v2 and how to migrate.
- [XML handling](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/docs/xml-and-html-handling/xml.md): Learn how to translate XML content with the DeepL API.

## OpenAPI Specs

- [openapi](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/openapi.yaml)
- [agent-api](https://deepl-c950b784-update-create-free-api-account-link.mintlify.app/api-reference/agent-api/agent-api.yaml)