The /v2/write/rephrase endpoint improves one or more texts by correcting spelling and grammar and rephrasing sentences for clarity. With the optional writing_style or tone parameters, the rewrite targets a specific style or tone. Its corrections-only counterpart, /v2/write/correct, is limited to fixing mistakes with minimal changes to wording.
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 style if the language does not yet support styles.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DeepL Documentation","description":"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.","colors":{"primary":"#0f2b46","light":"#ffffff","dark":"#0f2b46"},"logo":{"light":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/logo/light_with_text.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=2dfc0d736effb479c0ac145abe2ab2c3","dark":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/logo/dark_with_text.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=1c796b7a29370a15d010c5f6cda342f3"},"favicon":"https://mintcdn.com/deepl-c950b784/QiF37QSCmRj62dXZ/_assets/favicon.svg?fit=max\u0026auto=format\u0026n=QiF37QSCmRj62dXZ\u0026q=85\u0026s=b46ca099e325b1b5f0ce2f0fc351e394","api":{"openapi":"api-reference/openapi.yaml","asyncapi":"api-reference/voice/voice.asyncapi.yaml","playground":{"proxy":false},"examples":{"defaults":"required","languages":["curl"]}},"appearance":{"default":"light","strict":false},"background":{"color":{"light":"#ffffff"}},"navbar":{"links":[{"href":"https://www.deepl.com/en/pro#api","label":"Pricing"}],"primary":{"type":"button","label":"Free API Key","href":"https://www.deepl.com/en/checkout?is_api=true"}},"footer":{"socials":{"facebook":"https://www.facebook.com/DeepLcom","linkedin":"https://www.linkedin.com/company/deepl","github":"https://github.com/DeepL","instagram":"https://www.instagram.com/deeplhq"},"links":[{"items":[{"label":"API Status","href":"https://status.deepl.com/?tab=api"},{"label":"DeepL Status","href":"https://status.deepl.com"},{"label":"Contact","href":"/docs/resources/contact"}]}]},"seo":{"metatags":{"google-site-verification":"0VDGg3gJk53xL5burIUykHtV_eBhXTp5AMdzaeffbbU"},"organization":{"id":"https://www.deepl.com/","name":"DeepL","legalName":"DeepL SE","url":"https://www.deepl.com","logo":"https://static.deepl.com/img/logo/deepl-logo-blue.svg","sameAs":["https://github.com/DeepL","https://www.linkedin.com/company/deepl","https://x.com/DeepLcom","https://www.instagram.com/deeplhq/","https://www.youtube.com/@DeepLcom"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Roboto"},"body":{"family":"Roboto"}},"integrations":{"cookies":{"key":"deepl_cookie_consent","value":"accepted"}},"banner":{"content":"Help shape the DeepL API roadmap. [Take the survey](https://deepl.qualtrics.com/jfe/form/SV_8fbjoZx1wQUkAC2)","dismissible":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page does not exist. Humans: check out the [Quickstart](/docs/getting-started/quickstart) or the [API reference](/api-reference/translate/request-translation). Machines: try [/llms.txt](/llms.txt), [the docs MCP server](https://developers.deepl.com/mcp), or OpenAPI specs for [Text](/api-reference/openapi.yaml) and [Voice](/api-reference/voice/voice.asyncapi.yaml)."}},"contextual":{"options":["copy","download-spec","chatgpt","claude","cursor","vscode"],"display":"header"},"markdown":{"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.","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. 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 \u003capi-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."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"deepl-c950b784","hasAudioNarration":false,"actualSubdomain":"deepl-c950b784","customDomains":["developers.deepl.com"],"gitSource":{"type":"github","owner":"deepl","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af35b057449a8e2dc9bdddf","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Customize","count":55},{"language":"default","tag":"Home","count":35},{"language":"default","tag":"Translate","count":23},{"language":"default","tag":"Glossaries","count":17},{"language":"default","tag":"Admin","count":14},{"language":"default","tag":"Style Rules","count":12},{"language":"default","tag":"Spoken Terms","count":10},{"language":"default","tag":"Text Translation","count":10},{"language":"default","tag":"Voice","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"cookie-banner.css","content":"#cookie-banner{position:fixed;bottom:0;left:0;width:100%;background:#0f2b46;color:#fff;padding:20px;display:flex;justify-content:space-between;align-items:center;gap:20px;z-index:10000;box-shadow:0 -2px 10px rgba(0, 0, 0, 0.2);font-family:Roboto, sans-serif}#cookie-banner-content{flex:1}#cookie-banner-text{margin:0;font-size:14px;line-height:1.5}#cookie-banner-text a{color:#4FC3F7;text-decoration:underline}#cookie-banner-buttons{display:flex;gap:12px;flex-shrink:0}#cookie-reject,#cookie-accept{padding:10px 20px;border-radius:4px;cursor:pointer;font-size:14px;font-weight:500;transition:all 0.2s;font-family:Roboto, sans-serif}#cookie-reject{background:transparent;color:#fff;border:1px solid #fff}#cookie-reject:hover{background:rgba(255, 255, 255, 0.1)}#cookie-accept{background:#fff;color:#0f2b46;border:none}#cookie-accept:hover{background:#e6e6e6}@media (max-width: 768px){#cookie-banner{flex-direction:column;align-items:stretch;gap:16px;padding:16px}#cookie-banner-buttons{width:100%;justify-content:stretch}#cookie-reject,#cookie-accept{flex:1}}"},{"filePath":"user-study-popup.css","content":"#user-study-popup{position:fixed;right:24px;bottom:24px;z-index:9999;pointer-events:none;font-family:Roboto, sans-serif}#user-study-card{position:relative;width:360px;max-width:calc(100vw - 48px);padding:24px;background:#ffffff;border:1px solid rgba(15, 43, 70, 0.12);border-radius:16px;box-shadow:0 20px 45px rgba(15, 43, 70, 0.16), 0 6px 16px rgba(15, 43, 70, 0.1);pointer-events:auto;transform:translateX(calc(100% + 48px));transition:transform 0.35s ease}#user-study-card.slide-in{transform:translateX(0)}#user-study-card.slide-out{transform:translateX(calc(100% + 48px));transition:transform 0.25s ease-in}#user-study-close{position:absolute;top:12px;right:12px;display:flex;align-items:center;justify-content:center;width:32px;height:32px;padding:0;border:0;border-radius:999px;background:transparent;color:#6b7280;font-size:24px;line-height:1;cursor:pointer}#user-study-close:hover{background:rgba(15, 43, 70, 0.06);color:#0f2b46}#user-study-eyebrow{margin:0 0 8px;color:#0f2b46;font-size:12px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase}#user-study-content h3{margin:0 28px 12px 0;color:#111827;font-size:22px;font-weight:700;line-height:1.2}#user-study-content p{margin:0 0 18px;color:#4b5563;font-size:14px;line-height:1.5}#user-study-cta{display:inline-flex;align-items:center;justify-content:center;width:100%;min-height:44px;border-radius:999px;background:#0f2b46;color:#ffffff;font-size:14px;font-weight:600;text-decoration:none}#user-study-cta:hover{background:#133858}@media (max-width: 480px){#user-study-popup{right:16px;bottom:16px;left:16px}#user-study-card{width:auto;max-width:none;padding:20px}#user-study-content h3{font-size:20px}}"},{"filePath":"navbar-cta.css","content":"html.dark #topbar-cta-button a>span:first-child{background-color:#FFFFFF!important}html.dark #topbar-cta-button a,html.dark #topbar-cta-button a span,html.dark #topbar-cta-button a svg{color:#292929!important}"}],"page":{"pagePath":"api-reference/improve-text/request-text-improvement","slug":"/api-reference/improve-text/request-text-improvement","pageMetadata":{"openapi":"post /v2/write/rephrase","title":"Improve text","description":"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.","href":"/api-reference/improve-text/request-text-improvement"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`/v2/write/rephrase`}),` endpoint improves one or more texts by correcting spelling and grammar and rephrasing sentences for clarity. With the optional `,_jsx(_components.code,{children:`writing_style`}),` or `,_jsx(_components.code,{children:`tone`}),` parameters, the rewrite targets a specific style or tone. Its corrections-only counterpart, `,_jsx(_components.a,{href:`/api-reference/improve-text/correct-text`,children:_jsx(_components.code,{children:`/v2/write/correct`})}),`, is limited to fixing mistakes with minimal changes to wording.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v2/write/rephrase","title":"Improve text","description":"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.","href":"/api-reference/improve-text/request-text-improvement"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/deepl-c950b784/79954643574228d7/analytics.js","/_mintlify/custom/deepl-c950b784/7c795428034ccd8b/cookie-banner.js","/_mintlify/custom/deepl-c950b784/e09568492714dd0f/user-study-popup.js","/_mintlify/custom/deepl-c950b784/06c83788a8296584/user-data.js"],"openApiReferenceData":{"operation":{"tags":["RephraseText"],"summary":"Improve text","operationId":"rephraseText","description":"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.","requestBody":"75bf61a7-13da-4202-a2c7-002e2f5a1e91","responses":{"200":"12dcf3a3-4079-4dc6-b632-58386e5c5d1f","400":"5d09253f-7e7e-4db5-a493-add71d1229a9","403":"f28a05d1-9a5d-43f5-b7db-3a1349fdefd1","413":"cc64a95a-03c3-4cdf-86c2-732f3dc4815b","415":"dc1e49a3-bb23-4160-a9f5-7cf3a0d129d0","429":"88f4d43a-e3bb-4b9d-9a77-f7b4440814de","456":"4b924ed3-7c8c-4eec-b6eb-fb5737aa30bd","500":"3011e0df-c836-4e03-8115-5ca46a0b7a73","504":"c5c4671a-24b0-4020-9b58-16b90cd39c94"},"security":["799b014a-4c1f-46bd-b146-c2a4b4fa7307"],"method":"post","type":"path","servers":["c4615c24-7d01-4e83-8ecc-9651dbe481cb","6eea3424-eb39-4207-bfbe-da2fb90a9e9c"],"path":"/v2/write/rephrase","baseUrlOptions":["https://api.deepl.com","https://api-free.deepl.com"],"title":"Improve text","codeSamples":[],"requestExampleLanguages":["bash"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested.","type":"array","x-default":["this is a example sentence to imprve"],"items":{"type":"string","example":"this is a example sentence to imprve","uniqueKey":"text.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"text","typeLabel":"string[]"},"target_lang":{"type":"string","description":"The language for the text improvement.","enum":["de","en","en-GB","en-US","es","fr","it","ja","ko","pt","pt-BR","pt-PT","zh","zh-Hans"],"example":"de","uniqueKey":"target_lang","typeLabel":"enum\u003cstring>"},"writing_style":{"type":"string","description":"Specify a style to rephrase your text in a way that fits your audience and goals.\nThe `prefer_` prefix allows falling back to the default style if the language does not yet support styles.","enum":["academic","business","casual","default","simple","prefer_academic","prefer_business","prefer_casual","prefer_simple"],"uniqueKey":"writing_style","typeLabel":"enum\u003cstring>"},"tone":{"type":"string","description":"Specify the desired tone for your text.\nThe `prefer_` prefix allows falling back to the default tone if the language does not yet support tones.","enum":["confident","default","diplomatic","enthusiastic","friendly","prefer_confident","prefer_diplomatic","prefer_enthusiastic","prefer_friendly"],"uniqueKey":"tone","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"text":["this is a example sentence to imprve"],"target_lang":"de"}}},"exampleType":"generated"},"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested.","type":"array","x-default":["this is a example sentence to imprve"],"items":{"type":"string","example":"this is a example sentence to imprve","uniqueKey":"text.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"text","typeLabel":"string[]"},"target_lang":{"type":"string","description":"The language for the text improvement.","enum":["de","en","en-GB","en-US","es","fr","it","ja","ko","pt","pt-BR","pt-PT","zh","zh-Hans"],"example":"de","uniqueKey":"target_lang","typeLabel":"enum\u003cstring>"},"writing_style":{"type":"string","description":"Specify a style to rephrase your text in a way that fits your audience and goals.\nThe `prefer_` prefix allows falling back to the default style if the language does not yet support styles.","enum":["academic","business","casual","default","simple","prefer_academic","prefer_business","prefer_casual","prefer_simple"],"uniqueKey":"writing_style","typeLabel":"enum\u003cstring>"},"tone":{"type":"string","description":"Specify the desired tone for your text.\nThe `prefer_` prefix allows falling back to the default tone if the language does not yet support tones.","enum":["confident","default","diplomatic","enthusiastic","friendly","prefer_confident","prefer_diplomatic","prefer_enthusiastic","prefer_friendly"],"uniqueKey":"tone","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"text":["this is a example sentence to imprve"],"target_lang":"de"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"12dcf3a3-4079-4dc6-b632-58386e5c5d1f":{"description":"Successful text improvement.","headers":{"X-Trace-ID":{"description":"A unique identifier for the request that can be included in bug reports to DeepL support.","schema":{"type":"string"},"example":"501c3d93cc0c4f11ae2f60a226c2f0f0"}},"content":{"application/json":{"schema":{"type":"object","properties":{"improvements":{"type":"array","minItems":1,"items":{"type":"object","properties":{"detected_source_language":{"description":"The language detected in the source text.","type":"string","example":"en","uniqueKey":"improvements.items.[INDEX].detected_source_language","typeLabel":"string"},"target_language":{"description":"The target language specified by the request.","type":"string","example":"en-US","uniqueKey":"improvements.items.[INDEX].target_language","typeLabel":"string"},"text":{"description":"The improved text.","type":"string","example":"This is a sample sentence to improve.","uniqueKey":"improvements.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"improvements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"improvements","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"improvements":[{"detected_source_language":"en","target_language":"en-US","text":"This is a sample sentence to improve."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"5d09253f-7e7e-4db5-a493-add71d1229a9":{"description":"Bad request. Please check error message and your parameters.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"f28a05d1-9a5d-43f5-b7db-3a1349fdefd1":{"description":"Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"cc64a95a-03c3-4cdf-86c2-732f3dc4815b":{"description":"The request size exceeds the limit.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"dc1e49a3-bb23-4160-a9f5-7cf3a0d129d0":{"description":"Unsupported Media Type. Must be application/json or application/x-www-form-urlencoded.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Unsupported Content-Type"},"examples":{"Example":{"title":"Example","value":{"message":"Unsupported Content-Type"}}},"exampleType":"examples"}},"exampleType":"examples"},"88f4d43a-e3bb-4b9d-9a77-f7b4440814de":{"description":"Too many requests. Please wait and resend your request.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"4b924ed3-7c8c-4eec-b6eb-fb5737aa30bd":{"description":"Quota exceeded. The character limit has been reached.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"3011e0df-c836-4e03-8115-5ca46a0b7a73":{"description":"Internal error.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"oneOf.0.code","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Error body returned by DeepL's edge infrastructure for failures that occur before a request reaches the API itself. The message is nested under `error`, unlike the application-level `ErrorResponse`. Clients that parse error bodies should handle both shapes.\n","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","example":"Bad Gateway.","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"},"c5c4671a-24b0-4020-9b58-16b90cd39c94":{"description":"Resource currently unavailable. Try again later.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.","example":"invalid_content_type","uniqueKey":"oneOf.0.code","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Error body returned by DeepL's edge infrastructure for failures that occur before a request reaches the API itself. The message is nested under `error`, unlike the application-level `ErrorResponse`. Clients that parse error bodies should handle both shapes.\n","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","example":"Bad Gateway.","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"invalid_content_type"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"799b014a-4c1f-46bd-b146-c2a4b4fa7307":{"auth_header":{"type":"apiKey","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","name":"Authorization","in":"header","x-default":"DeepL-Auth-Key ","scopes":[],"schemeName":"auth_header"}}},"servers":{"c4615c24-7d01-4e83-8ecc-9651dbe481cb":{"url":"https://api.deepl.com","description":"DeepL API Pro"},"6eea3424-eb39-4207-bfbe-da2fb90a9e9c":{"url":"https://api-free.deepl.com","description":"DeepL API Free"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","name":"Authorization","in":"header","x-default":"DeepL-Auth-Key ","scopes":[],"schemeName":"auth_header"},"schema":{"title":"Authorization","type":"string","description":"Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key \u003capi-key>`\n","isRequired":true,"default":"DeepL-Auth-Key ","typeLabel":"string","deprecated":false},"schemeName":"auth_header","name":"Authorization"}],"title":"auth_header"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"deepl-c950b784","siteName":"DeepL Documentation","title":"Improve text - DeepL Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-22T10:10:29.117Z","originalFileLocation":"api-reference/improve-text/request-text-improvement.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DeepL Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Improve text - DeepL Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DeepL Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://deepl-c950b784.mintlify.site/_mintlify/api/og/v2?division=Write\u0026amp;title=Improve+text\u0026amp;description=Improves+text+by+correcting+spelling+and+grammar+and+rewriting+for+a+target+writing+style+or+tone.\u0026amp;theme=cbe3b3ecb06f10c89ca05ab6\u0026amp;signature=ec1f8d68c7f8f36e09f77aa0761a097567021c04b20c14cb9b1e9deb3311507e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Improve text - DeepL Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://deepl-c950b784.mintlify.site/_mintlify/api/og/v2?division=Write\u0026amp;title=Improve+text\u0026amp;description=Improves+text+by+correcting+spelling+and+grammar+and+rewriting+for+a+target+writing+style+or+tone.\u0026amp;theme=cbe3b3ecb06f10c89ca05ab6\u0026amp;signature=ec1f8d68c7f8f36e09f77aa0761a097567021c04b20c14cb9b1e9deb3311507e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/deepl-c950b784/hSlhr1iEcolF1mhS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DeepL Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f2b46\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"0VDGg3gJk53xL5burIUykHtV_eBhXTp5AMdzaeffbbU\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/improve-text/request-text-improvement.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.deepl.com/\",\"name\":\"DeepL\",\"legalName\":\"DeepL SE\",\"url\":\"https://www.deepl.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://static.deepl.com/img/logo/deepl-logo-blue.svg\"},\"sameAs\":[\"https://github.com/DeepL\",\"https://www.linkedin.com/company/deepl\",\"https://x.com/DeepLcom\",\"https://www.instagram.com/deeplhq/\",\"https://www.youtube.com/@DeepLcom\"]},{\"@type\":\"WebSite\",\"@id\":\"https://developers.deepl.com#website\",\"name\":\"DeepL Documentation\",\"url\":\"https://developers.deepl.com\",\"publisher\":{\"@id\":\"https://www.deepl.com/\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement#webpage\",\"url\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement\",\"name\":\"Improve text\",\"description\":\"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\",\"dateModified\":\"2026-05-22T10:10:29.117Z\",\"isPartOf\":{\"@id\":\"https://developers.deepl.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Translate\",\"item\":\"https://developers.deepl.com/api-reference/translate/request-translation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Improve text\",\"item\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement#apireference\",\"headline\":\"Improve text\",\"name\":\"Improve text\",\"description\":\"Improves text by correcting spelling and grammar and rewriting for a target writing style or tone.\",\"url\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement\",\"mainEntityOfPage\":{\"@id\":\"https://developers.deepl.com/api-reference/improve-text/request-text-improvement#webpage\"},\"dateModified\":\"2026-05-22T10:10:29.117Z\",\"publisher\":{\"@id\":\"https://www.deepl.com/\"},\"isPartOf\":{\"@id\":\"https://developers.deepl.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DeepL Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DeepL\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/improve-text/request-text-improvement.md","siteName":"DeepL Documentation","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/docs/getting-started/quickstart"}]},{"tab":"Translate","icon":"language","pages":[{"title":"Translate","href":"/docs/translate/overview"}]},{"tab":"Voice","icon":"waveform-lines","pages":[{"title":"Voice","href":"/docs/voice/overview"}]},{"tab":"Customize","icon":"wand-magic-sparkles","pages":[{"title":"Customize","href":"/docs/customize/overview"}]},{"tab":"Admin","icon":"sliders","pages":[{"title":"Admin","href":"/docs/admin/overview"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Translate","pages":[{"group":"Translate Text","pages":[{"openapi":"post /v2/translate","title":"Translate text","href":"/api-reference/translate/request-translation"}]},{"group":"Translate Documents","pages":[{"openapi":"post /v2/document","title":"Upload and translate a document","href":"/api-reference/document/upload-and-translate-a-document"},{"openapi":"post /v2/document/{document_id}","title":"Check document status","href":"/api-reference/document/check-document-status"},{"openapi":"post /v2/document/{document_id}/result","title":"Download translated document","href":"/api-reference/document/download-translated-document"}]},{"group":"Quality Evaluation","tag":"BETA","pages":[{"openapi":"get /v1/quality-evaluations/{job_id}","tag":"BETA","title":"Poll for the evaluation result","description":"Poll a document's quality evaluation for its status and retrieve the per-segment report of translation issues once it completes.","href":"/api-reference/quality-evaluations/poll"}]},{"group":"Write","pages":[{"openapi":"post /v2/write/rephrase","title":"Improve text","href":"/api-reference/improve-text/request-text-improvement"},{"openapi":"post /v2/write/correct","title":"Correct text","description":"Fixes spelling and grammar errors with minimal changes to wording.","href":"/api-reference/improve-text/correct-text"}]},{"title":"Detect Language","tag":"BETA","href":"/api-reference/detect-language/detect-language-beta"}]},{"group":"Customize","pages":[{"group":"Glossaries","pages":[{"openapi":"post /v3/glossaries","title":"Create a glossary","href":"/api-reference/multilingual-glossaries/create-a-glossary"},{"openapi":"get /v3/glossaries","title":"List all glossaries","href":"/api-reference/multilingual-glossaries/list-all-glossaries"},{"openapi":"get /v3/glossaries/{glossary_id}","title":"Retrieve glossary details","href":"/api-reference/multilingual-glossaries/retrieve-glossary-details"},{"openapi":"patch /v3/glossaries/{glossary_id}","title":"Edit glossary details","href":"/api-reference/multilingual-glossaries/edit-glossary-details"},{"openapi":"get /v3/glossaries/{glossary_id}/entries","title":"Retrieve glossary entries","href":"/api-reference/multilingual-glossaries/retrieve-glossary-entries"},{"openapi":"delete /v3/glossaries/{glossary_id}","title":"Delete a glossary","href":"/api-reference/multilingual-glossaries/delete-a-glossary"},{"openapi":"delete /v3/glossaries/{glossary_id}/dictionaries","sidebarTitle":"Delete a glossary dictionary","title":"Deletes the dictionary associated with the given language pair with the given glossary ID.","href":"/api-reference/multilingual-glossaries/deletes-the-dictionary-associated-with-the-given-language-pair-with-the-given-glossary-id"},{"openapi":"put /v3/glossaries/{glossary_id}/dictionaries","sidebarTitle":"Create or replace glossary entries","title":"Replaces or creates a dictionary in the glossary with the specified entries.","href":"/api-reference/multilingual-glossaries/replaces-or-creates-a-dictionary-in-the-glossary-with-the-specified-entries"},{"group":"Glossaries v2","tag":"DEPRECATED","pages":[{"openapi":"get /v2/glossary-language-pairs","title":"List language pairs supported for glossaries","tag":"DEPRECATED","playground":"none","href":"/api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries"},{"openapi":"post /v2/glossaries","title":"Create a glossary","playground":"none","href":"/api-reference/glossaries/create-a-glossary"},{"openapi":"get /v2/glossaries","title":"List all glossaries","playground":"none","href":"/api-reference/glossaries/list-all-glossaries"},{"openapi":"get /v2/glossaries/{glossary_id}","title":"Retrieve glossary details","playground":"none","href":"/api-reference/glossaries/retrieve-glossary-details"},{"openapi":"get /v2/glossaries/{glossary_id}/entries","title":"Retrieve glossary entries","playground":"none","href":"/api-reference/glossaries/retrieve-glossary-entries"},{"openapi":"delete /v2/glossaries/{glossary_id}","title":"Delete a glossary","playground":"none","href":"/api-reference/glossaries/delete-a-glossary"}]}]},{"group":"Spoken Terms","pages":[{"openapi":"post /v3/spoken-terms","title":"Create Spoken Terms collection","href":"/api-reference/spoken-terms/create-spoken-terms-collection"},{"openapi":"get /v3/spoken-terms","title":"List all Spoken Terms collections","href":"/api-reference/spoken-terms/list-all-spoken-terms"},{"openapi":"get /v3/spoken-terms/{spoken_terms_id}","title":"Retrieve Spoken Terms collection details","href":"/api-reference/spoken-terms/retrieve-spoken-terms-details"},{"openapi":"patch /v3/spoken-terms/{spoken_terms_id}","title":"Edit Spoken Terms collection details","href":"/api-reference/spoken-terms/edit-spoken-terms-details"},{"openapi":"get /v3/spoken-terms/{spoken_terms_id}/entries","title":"Retrieve Spoken Terms entries","href":"/api-reference/spoken-terms/retrieve-spoken-terms-entries"},{"openapi":"delete /v3/spoken-terms/{spoken_terms_id}","title":"Delete Spoken Terms collection","href":"/api-reference/spoken-terms/delete-spoken-terms"},{"openapi":"delete /v3/spoken-terms/{spoken_terms_id}/term-lists","title":"Delete a term list","href":"/api-reference/spoken-terms/delete-spoken-terms-list"},{"openapi":"put /v3/spoken-terms/{spoken_terms_id}/term-lists","title":"Replace or create a term list","href":"/api-reference/spoken-terms/replace-or-create-term-list"}]},{"group":"Style Profiles","pages":[{"openapi":"get /v3/style_profiles","title":"List style profiles","href":"/api-reference/style-profiles/list-all-style-profiles"},{"openapi":"post /v3/style_profiles","title":"Create a style profile","href":"/api-reference/style-profiles/create-style-profile"},{"openapi":"get /v3/style_profiles/{style_profile_id}","title":"Retrieve a style profile","href":"/api-reference/style-profiles/get-style-profile"},{"openapi":"patch /v3/style_profiles/{style_profile_id}","title":"Update a style profile","href":"/api-reference/style-profiles/update-style-profile"},{"openapi":"delete /v3/style_profiles/{style_profile_id}","title":"Delete a style profile","href":"/api-reference/style-profiles/delete-style-profile"}]},{"group":"Style Rules","pages":[{"openapi":"get /v3/style_rules","title":"Get all style rule lists","href":"/api-reference/style-rules/list-all-style-rules"},{"openapi":"post /v3/style_rules","title":"Create a style rule list","href":"/api-reference/style-rules/create-style-rule"},{"openapi":"get /v3/style_rules/{style_id}","title":"Get a style rule list","href":"/api-reference/style-rules/get-style-rule"},{"openapi":"patch /v3/style_rules/{style_id}","title":"Update a style rule list's name","href":"/api-reference/style-rules/update-style-rule"},{"openapi":"put /v3/style_rules/{style_id}/configured_rules","title":"Replace configured rules","href":"/api-reference/style-rules/update-configured-rules"},{"openapi":"delete /v3/style_rules/{style_id}","title":"Delete a style rule list","href":"/api-reference/style-rules/delete-style-rule"},{"openapi":"post /v3/style_rules/{style_id}/custom_instructions","title":"Create a custom instruction","href":"/api-reference/style-rules/create-custom-instruction"},{"openapi":"get /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Get a custom instruction","href":"/api-reference/style-rules/get-custom-instruction"},{"openapi":"put /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Replace a custom instruction","href":"/api-reference/style-rules/update-custom-instruction"},{"openapi":"delete /v3/style_rules/{style_id}/custom_instructions/{instruction_id}","title":"Delete a custom instruction","href":"/api-reference/style-rules/delete-custom-instruction"}]},{"group":"Translation Memory","pages":[{"openapi":"get /v3/translation_memories","title":"List translation memories","href":"/api-reference/translation-memory/list-translation-memories"},{"openapi":"get /v3/translation_memories/{translation_memory_id}","title":"Retrieve a translation memory","href":"/api-reference/translation-memory/retrieve-a-translation-memory"},{"openapi":"get /v3/translation_memories/{translation_memory_id}/segments","title":"List translation memory segments","href":"/api-reference/translation-memory/list-translation-memory-segments"},{"openapi":"post /v3/translation_memories/import","title":"Import a translation memory","href":"/api-reference/translation-memory/import-a-translation-memory"},{"openapi":"post /v3/translation_memories/{translation_memory_id}/export","title":"Export a translation memory","href":"/api-reference/translation-memory/export-a-translation-memory"},{"openapi":"get /v3/translation_memories/jobs/{job_id}","title":"Retrieve an import or export job","href":"/api-reference/translation-memory/retrieve-a-translation-memory-job"},{"openapi":"delete /v3/translation_memories/{translation_memory_id}","title":"Delete a translation memory","href":"/api-reference/translation-memory/delete-a-translation-memory"}]}]},{"group":"Voice","pages":[{"group":"Real-Time","pages":[{"openapi":"post /v3/voice/realtime","title":"Request Session","href":"/api-reference/voice/request-session"},{"asyncapi":"voiceStream","title":"WebSocket Streaming","href":"/api-reference/voice/websocket-streaming"},{"openapi":"get /v3/voice/realtime","title":"Reconnect Session","href":"/api-reference/voice/reconnect-session"}]}]},{"group":"Translate Audio Files","hidden":true,"pages":[{"title":"Translate Audio Files","sidebarTitle":"Overview","href":"/api-reference/jobs-voice-translate"},{"openapi":"post /v1/jobs/voice/translate","title":"Create a voice translation job","href":"/api-reference/jobs-voice-translate/create-voice-translate-job"},{"openapi":"get /v1/jobs/voice/translate/{job_id}","title":"Get voice translation job status","href":"/api-reference/jobs-voice-translate/get-voice-translate-job-status"},{"title":"Reference","sidebarTitle":"Reference","href":"/api-reference/jobs-voice-translate/reference"}]},{"group":"Languages","pages":[{"group":"Languages v3","pages":[{"openapi":"get /v3/languages","title":"Retrieve languages","href":"/api-reference/languages/retrieve-languages-by-resource"},{"openapi":"get /v3/languages/resources","title":"Retrieve language resources","href":"/api-reference/languages/retrieve-resources"}]},{"group":"Languages v2","tag":"DEPRECATED","pages":[{"openapi":"get /v2/languages","title":"Retrieve supported languages (v2)","tag":"DEPRECATED","href":"/api-reference/languages/retrieve-supported-languages"}]}]},{"group":"Admin","pages":[{"group":"Managing Developer Keys","pages":[{"openapi":"post /v2/admin/developer-keys","title":"Create a developer key","href":"/api-reference/admin-api/managing-developer-keys/create-key"},{"openapi":"get /v2/admin/developer-keys","title":"Get developer keys","href":"/api-reference/admin-api/managing-developer-keys/get-keys"},{"openapi":"put /v2/admin/developer-keys/deactivate","title":"Deactivate a developer key","href":"/api-reference/admin-api/managing-developer-keys/deactivate-key"},{"openapi":"put /v2/admin/developer-keys/label","title":"Rename a developer key","href":"/api-reference/admin-api/managing-developer-keys/rename-key"},{"openapi":"put /v2/admin/developer-keys/limits","title":"Set developer key limits","href":"/api-reference/admin-api/managing-developer-keys/set-usage-limits"}]},{"group":"Usage \u0026 Quota","pages":[{"openapi":"get /v2/usage","title":"Check usage and limits","href":"/api-reference/usage-and-quota/check-usage-and-limits"}]},{"group":"Organization Usage Analytics","pages":[{"openapi":"get /v2/admin/analytics","title":"Get usage analytics","href":"/api-reference/admin-api/get-usage-analytics"},{"openapi":"get /v2/admin/analytics/custom-tags","title":"Get custom tag usage analytics","href":"/api-reference/admin-api/get-custom-tag-usage-analytics"}]}]}]}]},"basePath":"","title":"Improve text - DeepL Documentation","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-6DXXLlfN.js","dist-CmKHfscc.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-C3kuh_dz.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","AssistantPageLink-U3mI6Ljh.js"]}