# DeepL Documentation > Developer documentation for the DeepL API: translate text and documents, transcribe and translate speech in real time, improve text, and customize output with glossaries, style rules, and translation memories. > ## Agent Instructions > Use the DeepL API when a task needs machine translation or text improvement, including translating text strings, whole documents with formatting preservation, or transcribing and translating live speech. Preferred terminology and phrasing may be enforced using customizations (glossaries, style rules, and translation memories). Retrieve supported languages for each product from the `/v3/languages` endpoints. > Do not use the DeepL API to write, summarize, answer, or classify: it transforms text you supply. Full when-to-use guidance, mapped to endpoints, is at https://developers.deepl.com/AGENTS.md. > Read the machine-readable API surface instead of inferring request shapes from prose: the REST spec is at https://developers.deepl.com/api-reference/openapi.yaml (also served as openapi.json) and the Voice WebSocket protocol is at https://developers.deepl.com/api-reference/voice/voice.asyncapi.yaml. Both are listed in the RFC 9727 catalog at https://developers.deepl.com/.well-known/api-catalog. These docs also expose an MCP server at https://developers.deepl.com/mcp (Streamable HTTP, no authentication). > Use https://api.deepl.com for Pro plans and https://api-free.deepl.com for the Free plan. Authenticate every request with the header `Authorization: DeepL-Auth-Key `. Never fabricate an API key: ask the user for one, or point them at https://developers.deepl.com/docs/getting-started/quickstart. > Errors use standard HTTP status codes with a JSON body containing a `message` field, plus a `code` field where available, and an `X-Trace-ID` response header that identifies the request in DeepL's logs. Log `X-Trace-ID` by default. Retry 429 and 5xx with exponential backoff. Do not retry 456, which means the account quota is exhausted, or 400, which means the request itself is invalid. > There is no fixed request-per-second limit and no `RateLimit` response headers: the service adapts to load. Throttle from the responses instead, honoring `Retry-After` when a 429 or 529 includes it, and capping in-flight requests. See https://developers.deepl.com/docs/best-practices/error-handling. ## Docs - [Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/quickstart.md): Get a DeepL API key and send your first translation request, with examples in curl and every official client library. - [About](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/about.md): What the DeepL API offers, the use cases it covers, and which product to reach for when adding translation to your app. - [Access and authentication](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/auth.md): Learn where to find your authentication key and how to access the DeepL API. - [SDKs](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/client-libraries.md): Using your favorite programming language with the DeepL API - [Languages supported](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/supported-languages.md): Every language the DeepL API supports, and how to retrieve the list programmatically with feature availability. - [Using the Languages API](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/languages/using-the-languages-api.md): Retrieve supported language and feature data across all DeepL API resources with the v3/languages endpoints, with pseudocode examples for common lookup patterns. - [Migrating from v2/languages](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/languages/migrating-from-v2-languages.md): How to migrate from the v2/languages endpoint to the v3/languages endpoints. - [Language release process](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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. - [Regional API Endpoints](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/regional-endpoints.md): Reference documentation for DeepL's regional API endpoints, including endpoint URLs, configuration, and technical specifications. - [Estimating Character Usage](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/estimating-character-usage.md): Learn how to estimate your DeepL API character usage to find the right plan. - [Pre-production checklist](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/pre-production-checklist.md): Here's what we recommend reviewing to get your DeepL API application ready for production. - [Error handling](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/error-handling.md): Parse DeepL API error responses, decide which status codes to retry, and throttle your client so it stays inside the API's limits. - [Subscription-level cost control](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/cost-control.md): Set a subscription-wide limit on characters, STT minutes, or STS minutes to cap your maximum costs. - [CORS requests](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/cors-requests.md): Why the DeepL API rejects requests sent directly from a browser, and how to call it from your backend instead. - [Usage and limits](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/usage-limits.md): Request size, header, and character limits for the DeepL API, plus the maximum upload size for each document format. - [Automating Indie Game Localization with the DeepL API and Godot](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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 - [Making API calls from client-side JavaScript](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/cookbook/nodejs-proxy.md): Two lightweight local proxies that let you try the DeepL API directly from a website - [Building a Document Translator with the DeepL API](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/cookbook/java-document-translator.md): Streamline document localization workflows with automated translation for businesses and developers - [Usage Analytics Dashboard](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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. - [Sending Custom Reporting Tags with Client Libraries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/cookbook/sending-custom-reporting-tags-from-client-libraries.md): Code snippets for attaching X-DeepL-Reporting-Tag to translate requests using the official DeepL client libraries. - [API Usage Logger](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/cookbook/api-usage-logger.md): Learn how to capture per-request DeepL API usage data and visualize it in a local dashboard. - [DeepL MCP Server: How to build and use translation in LLM applications](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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. - [Project: Google Sheets](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/cookbook/google-sheets.md): Open-source example showing how to build a Google Sheets App using the DeepL API. - [DeepL CLI](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/deepl-cli.md): Install and use the DeepL CLI to translate text, documents, and more from your terminal. - [DeepL MCP Server](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/deepl-mcp-server.md): Use the DeepL MCP Server to add translation capabilities to Claude, Cursor, and other AI agents. - [Docs MCP Server](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/docs-mcp-server.md): Connect your AI tools to the DeepL developer documentation for source-grounded answers about the DeepL API. - [Postman](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/getting-started/test-your-api-requests-with-postman.md): Use our official Postman collection to get familiar with and test the DeepL API. - [Developer Community](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/deepl-developer-community.md): Join the official DeepL developer community on Discord to ask questions and talk to other developers building on the API. - [OpenAPI spec](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/open-api-spec.md): How to fetch the OpenAPI specifications for the DeepL API - [API Status Page](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/api-status-page.md): Monitor the operational status and availability of the DeepL API - [Changelog](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/roadmap-and-release-notes.md): The latest features and improvements in the DeepL API, plus what's coming next - [Alpha and beta features](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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-docs-agentic-readiness-round-2.mintlify.site/docs/resources/breaking-changes-change-notices.md): Planned DeepL API deprecations and breaking changes that may affect your integration, with the notice for each. - [July 2024: Deprecation of insecure cipher suites](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/breaking-changes-change-notices/july-2024-deprecation-of-insecure-cipher-suites.md): DeepL deprecated insecure TLS cipher suites in 2024. Check which suites your TLS library negotiates if handshakes fail. - [March 2025: Deprecating GET requests to /translate and authenticating with auth_key](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/breaking-changes-change-notices/march-2025-deprecating-get-requests-to-translate-and-authenticating-with-auth_key.md): DeepL deprecated GET requests to /translate and auth_key authentication in March 2025. Use POST with an Authorization header. - [November 2025: Deprecation of query parameter and request body authentication](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods.md): DeepL is removing auth_key query parameter and request body authentication. Move to the Authorization header before the deadline. - [Contact](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/contact.md): Find the right DeepL channel to get help with our API. - [Privacy](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/resources/privacy.md): Where to find DeepL's privacy policy, terms, and data security information, and what to plan for in your integration. - [Translate](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/overview.md): Translate text strings and complete documents with the DeepL API. Find quickstarts, markup handling guides, and customization options. - [Translate Text Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/translate-text-quickstart.md): Send your first text translation request to the DeepL API and batch multiple strings into a single call. - [How to Use the Context Parameter Effectively](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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. - [Translating Large Volumes of Text](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/translating-large-volumes.md): Batch texts, control sentence splitting, and parallelize requests to translate high volumes efficiently with the text translation endpoint. - [Understanding Model Types](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/understanding-model-types.md): How the model_type parameter chooses between latency-optimized and quality-optimized translation models, and how DeepL selects the model for each request. - [How to Use Custom Reporting Tags](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/examples-and-guides/how-to-use-custom-reporting-tags.md): Learn how to attach reporting tags to text translation and Voice API requests so you can break down usage by team, project, or category. - [How to Translate Between Language Variants](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/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. - [Mustache placeholder tags](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/learning-how-tos/examples-and-guides/placeholder-tags.md): An example for working with placeholder tags—in this case, Mustache tags. - [Translating XML](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/translating-xml.md): Learn how to translate XML content with the DeepL API while preserving its structure, and how to control sentence splitting. - [Translating HTML](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/translating-html.md): Learn how to translate HTML content with the DeepL API and exclude specific elements from translation. - [Language detection](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/language-detection.md): How DeepL detects the source language automatically, and why setting it yourself improves translation quality. - [Translate Documents Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/translate-documents-quickstart.md): Upload a Word document to the DeepL API, poll its translation status, and download the translated file, in three curl calls or one client library call. - [Document translations](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/best-practices/document-translations.md): Handle file size limits, status codes, and error details when translating documents with the DeepL API. - [Write Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/write-quickstart.md): Improve your first text with the DeepL Write API: rephrase for clarity, apply corrections-only mode, and change the writing style. - [Controlling Writing Style and Tone](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/translate/controlling-writing-style-and-tone.md): Steer Write API output with the writing_style and tone parameters: available values, per-language support, and prefer_ fallback behavior. - [DeepL Voice API](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/overview.md): Transcribe and translate spoken audio in real time with the DeepL Voice API. Find the streaming guide, core concepts, and language and format reference. - [Real-Time Voice Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/real-time-voice-quickstart.md): Stream microphone audio to the DeepL Voice API from Python and print live translations to your terminal as the speaker talks. - [Understanding Voice Sessions](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/understanding-voice-sessions.md): Understand the lifecycle of a DeepL Voice API session: how connections are established, how tokens secure reconnection, and how audio and results flow. - [Message Encoding](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/message-encoding.md): Choose between JSON and MessagePack encoding for DeepL Voice API WebSocket messages, and avoid the frame type and map encoding pitfalls. - [Supported Voice Languages](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/supported-voice-languages.md): Language availability for the DeepL Voice API: transcription, translation, and translated speech support per language. - [Voice API Requirements](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/voice/voice-api-requirements.md): Audio format requirements and session limits for the DeepL Voice API: supported codecs and containers, chunk sizes, and connection rules. - [Customize](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/overview.md): Tailor DeepL translations to your domain with glossaries, style rules, custom instructions, and translation memories. - [How to Apply Customizations to Language Variants](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/customizations-for-variants.md): Learn how to apply glossaries and style rules when translating into language variants like FR-CA or EN-GB. - [Glossaries in the Real World](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/glossaries-in-the-real-world.md): A quick guide to using DeepL glossaries in translations - [Managing Glossaries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/managing-glossaries.md): Create, edit, retrieve, and delete DeepL glossaries with the v3 endpoints, and apply them in translation requests. - [Glossary v2 vs v3 Endpoints](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/glossary-v2-vs-v3-endpoints.md): How the v3 glossary endpoints differ from the deprecated v2 endpoints, what to watch out for when mixing them, and how to work with v2's immutability. - [Using Style Rules](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/using-style-rules.md): Create style rule lists with configured rules and custom instructions, and apply them to translations with the style_id parameter. - [Custom instructions](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/custom-instructions.md): Learn how to create effective custom instructions to customize your translation behavior - [Improving Transcription with Spoken Terms](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/improving-transcription-with-spoken-terms.md): Keep company names, acronyms, and product terminology transcribed correctly in Voice API sessions by creating and maintaining a Spoken Terms collection. - [Spoken Terms Requirements](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/spoken-terms-requirements.md): Size limits and content rules for Spoken Terms collections and term lists. - [Using Translation Memories](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/customize/using-translation-memories.md): Learn how to retrieve your translation memories and use them in translation requests - [Admin](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/overview.md): Manage API keys, control what each key can access, and monitor usage across your organization, from the account UI or programmatically with the Admin API. - [Admin API Quickstart](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/quickstart.md): Create a developer API key, set a usage limit on it, and pull a per-key usage report in four calls to the Admin API. - [Managing API Keys in the Account UI](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/managing-api-keys.md): Create, rename, deactivate, and set usage limits and permissions on DeepL API keys in the account UI. - [Understanding API Key Permissions](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/api-key-permissions.md): Why scoped API keys exist, how DeepL enforces permission scopes, and when to choose a scoped key over an unrestricted one. - [Permission Scopes](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/permission-scopes.md): Every permission scope for DeepL developer API keys and the endpoints each scope covers. - [Retrieving Usage Data](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/docs/admin/retrieving-usage-data.md): Compare DeepL's usage data sources and pull character and minute consumption for your account, API keys, or custom tags. - [Translate text](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translate/request-translation.md): Translate text between any supported language pair, with options for formality, glossaries, tag handling, and context. - [Upload and translate a document](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/document/upload-and-translate-a-document.md): Upload a document for translation and receive the document ID and key needed to check status and download the result. - [Check document status](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/document/check-document-status.md): Check whether an uploaded document has finished translating, along with its billed character count and any error. - [Download translated document](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/document/download-translated-document.md): Download the translated file once a document translation job has finished. Results are available for a limited time. - [Improve text](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/improve-text/request-text-improvement.md): Improves text by correcting spelling and grammar and rewriting for a target writing style or tone. - [Correct text](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/improve-text/correct-text.md): Fixes spelling and grammar errors with minimal changes to wording. - [Detect Language](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/detect-language/detect-language-beta.md): Detect the language of text using DeepL's language detection service - [Create a glossary](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/create-a-glossary.md): Create a v3 multilingual glossary holding one or more dictionaries, each covering a source and target language pair. - [List all glossaries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/list-all-glossaries.md): List every v3 multilingual glossary on your account with its metadata, without returning the entries. - [Retrieve glossary details](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/retrieve-glossary-details.md): Retrieve the metadata for a single v3 multilingual glossary, including its dictionaries, without the entries. - [Edit glossary details](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/edit-glossary-details.md): Rename a v3 multilingual glossary, or edit the dictionary for one source and target language pair. - [Retrieve glossary entries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/retrieve-glossary-entries.md): Retrieve the term pairs stored in a v3 multilingual glossary dictionary, returned in TSV format. - [Delete a glossary](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/delete-a-glossary.md): Delete a v3 multilingual glossary along with all of its dictionaries and entries. This cannot be undone. - [Deletes the dictionary associated with the given language pair with the given glossary ID.](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/deletes-the-dictionary-associated-with-the-given-language-pair-with-the-given-glossary-id.md): Delete a single dictionary from a v3 multilingual glossary by its source and target language pair. - [Replaces or creates a dictionary in the glossary with the specified entries.](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/replaces-or-creates-a-dictionary-in-the-glossary-with-the-specified-entries.md): Create a dictionary in a v3 multilingual glossary, or replace the entries in an existing one, for one language pair. - [List language pairs supported for glossaries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries.md): Reference for the deprecated v2/glossary-language-pairs endpoint. New integrations should use v3/languages instead. - [Create a glossary](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/glossaries/create-a-glossary.md): Create a v2 glossary from a list of source and target term pairs for a single language pair. - [List all glossaries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/glossaries/list-all-glossaries.md): List every v2 glossary on your account with its metadata, without returning the glossary entries. - [Retrieve glossary details](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/glossaries/retrieve-glossary-details.md): Retrieve the metadata for a single v2 glossary, including its language pair and entry count, without the entries. - [Retrieve glossary entries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/glossaries/retrieve-glossary-entries.md): Retrieve the term pairs stored in a single v2 glossary, in the format requested through the Accept header. - [Delete a glossary](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/glossaries/delete-a-glossary.md): Delete a v2 glossary and all of its entries. Deleted glossaries cannot be recovered. - [Create Spoken Terms collection](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/create-spoken-terms-collection.md): Create a new Spoken Terms collection with one or more term lists for voice transcription - [List all Spoken Terms collections](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/list-all-spoken-terms.md): Retrieve all Spoken Terms collections and their metadata - [Retrieve Spoken Terms collection details](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/retrieve-spoken-terms-details.md): Get metadata for a specific Spoken Terms collection, including term list information - [Edit Spoken Terms collection details](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/edit-spoken-terms-details.md): Update the collection name or merge new terms into an existing term list - [Retrieve Spoken Terms entries](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/retrieve-spoken-terms-entries.md): Get the actual terms for a specific language from a Spoken Terms collection - [Delete Spoken Terms collection](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/delete-spoken-terms.md): Remove a Spoken Terms collection and all its term lists - [Delete a term list](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/delete-spoken-terms-list.md): Remove a term list for a specific language from the Spoken Terms collection - [Replace or create a term list](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/spoken-terms/replace-or-create-term-list.md): Replace an existing term list for a language, or create a new one if it doesn't exist - [Get all style rule lists](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/list-all-style-rules.md): List every style rule list on your account, with the configured rules and custom instructions on each. - [Create a style rule list](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/create-style-rule.md): Create a style rule list, the container for the configured rules and custom instructions applied to translations. - [Get a style rule list](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/get-style-rule.md): Retrieve a single style rule list, including its configured rules and custom instructions. - [Update a style rule list's name](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/update-style-rule.md): Rename an existing style rule list without changing its configured rules or custom instructions. - [Replace configured rules](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/update-configured-rules.md): Replace the full set of configured rules on a style rule list. Rules left out of the request are removed. - [Delete a style rule list](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/delete-style-rule.md): Delete a style rule list along with its configured rules and custom instructions. - [Create a custom instruction](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/create-custom-instruction.md): Add a custom instruction to a style rule list to shape translation output beyond the configured rules. - [Get a custom instruction](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/get-custom-instruction.md): Retrieve a single custom instruction from a style rule list by its instruction ID. - [Replace a custom instruction](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/update-custom-instruction.md): Replace the text of an existing custom instruction on a style rule list. - [Delete a custom instruction](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/style-rules/delete-custom-instruction.md): Remove a single custom instruction from a style rule list, leaving its configured rules in place. - [List translation memories](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/list-translation-memories.md): Retrieve the translation memories on your account, which store previously created translations for reuse. - [Retrieve a translation memory](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/retrieve-a-translation-memory.md): Learn how to fetch a single translation memory's languages, segment count, and timestamps by its ID. - [List translation memory segments](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/list-translation-memory-segments.md): Learn how to page through the source segments and translations stored in a translation memory using cursor-based pagination. - [Import a translation memory](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/import-a-translation-memory.md): Learn how to create a translation memory by declaring a TMX file, uploading it to a signed URL, and polling the import job. - [Export a translation memory](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/export-a-translation-memory.md): Learn how to export a translation memory as a TMX file, including how DeepL reuses recent exports and when it returns 409. - [Retrieve an import or export job](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/retrieve-a-translation-memory-job.md): Learn how to poll a translation memory import or export job and read its status values and results. - [Delete a translation memory](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/translation-memory/delete-a-translation-memory.md): Learn how to permanently delete a translation memory and all of its segments. - [Request Session](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/voice/request-session.md): Request a real-time voice translation session and receive the WebSocket streaming URL to connect to. - [WebSocket Streaming](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/voice/websocket-streaming.md): AsyncAPI reference for the real-time voice WebSocket protocol, covering the messages sent in each direction. - [Reconnect Session](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/voice/reconnect-session.md): Reconnect to an interrupted real-time voice translation session and resume streaming audio. - [Retrieve languages](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/languages/retrieve-languages-by-resource.md): Retrieve the languages a DeepL API resource supports, including source and target roles and per-resource features. - [Retrieve language resources](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/languages/retrieve-resources.md): Learn how to retrieve the list of DeepL API resources and their supported language features. - [Retrieve supported languages (v2)](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/languages/retrieve-supported-languages.md): Reference for the deprecated v2/languages endpoint. New integrations should use the v3/languages endpoints instead. - [Create a developer key](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/managing-developer-keys/create-key.md): Create a new DeepL API key for your organization as an admin, using the Admin API. - [Get developer keys](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/managing-developer-keys/get-keys.md): List every DeepL API key in your organization as an admin, including each key's label and usage limits. - [Deactivate a developer key](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/managing-developer-keys/deactivate-key.md): Deactivate a DeepL API key as an admin so it can no longer be used to authenticate requests. - [Rename a developer key](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/managing-developer-keys/rename-key.md): Change the label on an existing DeepL API key as an admin, using the Admin API. - [Set developer key limits](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/managing-developer-keys/set-usage-limits.md): Set or update the usage limit on an individual DeepL API key as an admin. - [Check usage and limits](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/usage-and-quota/check-usage-and-limits.md): Retrieve near-real-time character usage and account limits for the current billing period. - [Get usage analytics](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/get-usage-analytics.md): Retrieve organization-wide DeepL API usage for a date range, optionally grouped by API key or by API key and day. - [Get custom tag usage analytics](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/admin-api/get-custom-tag-usage-analytics.md): Retrieve DeepL API usage broken down by custom tag for a date range, optionally aggregated by day, with paginated results. ## OpenAPI Specs - [openapi](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/openapi.yaml) ## AsyncAPI Specs - [voice.asyncapi](https://deepl-c950b784-docs-agentic-readiness-round-2.mintlify.site/api-reference/voice/voice.asyncapi.yaml)