From aaae44672cfba6fa0efa9c88df0a85f9bad3fbb4 Mon Sep 17 00:00:00 2001 From: JanEbbing Date: Fri, 27 Mar 2026 15:53:32 +0000 Subject: [PATCH 1/7] Update Write API docs for new capabilities --- api-reference/improve-text.mdx | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/api-reference/improve-text.mdx b/api-reference/improve-text.mdx index 8c998ea..83b03ab 100644 --- a/api-reference/improve-text.mdx +++ b/api-reference/improve-text.mdx @@ -60,11 +60,9 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested. Each of the parameter values may contain multiple sentences. - - All texts **must** be in the same language. - The language of the improved text. A list of supported languages have not yet been added to the `/languages` endpoint. At the time of the beta, the following languages are supported: + The language of the improved text. A list of supported languages have not yet been added to the `/languages` endpoint. As of March 2026, the following languages are supported: * `de` (German) * `en-GB` (British English) @@ -72,8 +70,11 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ * `es` (Spanish) * `fr` (French) * `it` (Italian) + * `ja` (Japanese) + * `ko` (Korean) * `pt-BR` (Brazilian Portuguese) * `pt-PT` (Portuguese) + * `ZH`/`zh-Hans` (simplified Chinese) The language of the source texts sent in the `text` parameter must match the target language (translating and improving text simultaneously is not yet supported). @@ -97,9 +98,15 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ Currently supported for the following target languages: - * `de` - * `en-GB` - * `en-US` + * `de` (German) + * `en-GB` (British English) + * `en-US` (American English) + * `es` (Spanish) + * `fr` (French) + * `it` (Italian) + * `pt-BR` (Brazilian Portuguese) + * `pt-PT` (Portuguese) + Styles prefixed with `prefer_` will fall back to the `default` style when used with a language that does not support styles (this is recommended for cases where no `target_lang` is set), the non-prefixed writing styles (except `default`) will return a HTTP 400 error in that case. @@ -124,9 +131,14 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ Currently supported for the following target languages: - * `de` - * `en-GB` - * `en-US` + * `de` (German) + * `en-GB` (British English) + * `en-US` (American English) + * `es` (Spanish) + * `fr` (French) + * `it` (Italian) + * `pt-BR` (Brazilian Portuguese) + * `pt-PT` (Portuguese) Tones prefixed with `prefer_` will fall back to the `default` tone when used with a language that does not support tones (this is recommended for cases where no `target_lang` is set), the non-prefixed tones (except `default`) will return a HTTP 400 error in that case. From e969acb618cb08e57b36a05347abe85bd3ebc156 Mon Sep 17 00:00:00 2001 From: Jan Ebbing Date: Fri, 27 Mar 2026 16:04:22 +0000 Subject: [PATCH 2/7] docs: Add write api release to release doc --- docs/resources/roadmap-and-release-notes.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/resources/roadmap-and-release-notes.mdx b/docs/resources/roadmap-and-release-notes.mdx index d80159f..195e503 100644 --- a/docs/resources/roadmap-and-release-notes.mdx +++ b/docs/resources/roadmap-and-release-notes.mdx @@ -11,6 +11,12 @@ rss: true +## March 27 - Write API Improvements +- Improved overall quality of the models used in the write API +- Expanded language support to Japanese (`JA`), Korean (`KO`) and (simplified) Chinese (`ZH` or `zh-Hans`) +- Expanded support of writing styles and tones to Spanish (`ES`), Italian (`IT`), French (`FR`), Portuguese (`pt-PT`) and Brazilian Portuguese (`pt-BR`) +- Allow sending texts in multiple source languages in the same request when no `target_lang` is set (similar to translate) + ## March 26 - Expanded Style Rules API - Added 5 new endpoints for style rule list operations: `POST /v3/style_rules`, `GET /v3/style_rules/{style_id}`, `PATCH /v3/style_rules/{style_id}`, `DELETE /v3/style_rules/{style_id}`, and `PUT /v3/style_rules/{style_id}/configured_rules`. - Added 4 new endpoints for managing custom instructions within style rule lists: `POST /v3/style_rules/{style_id}/custom_instructions`, `GET /v3/style_rules/{style_id}/custom_instructions/{instruction_id}`, `PUT /v3/style_rules/{style_id}/custom_instructions/{instruction_id}`, and `DELETE /v3/style_rules/{style_id}/custom_instructions/{instruction_id}`. From 7c7bcf431f0a02b49e2135eaa3e215840d31edd5 Mon Sep 17 00:00:00 2001 From: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> Date: Fri, 27 Mar 2026 12:09:45 -0400 Subject: [PATCH 3/7] Revise Write API release notes --- docs/resources/roadmap-and-release-notes.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/resources/roadmap-and-release-notes.mdx b/docs/resources/roadmap-and-release-notes.mdx index 195e503..d1aaee6 100644 --- a/docs/resources/roadmap-and-release-notes.mdx +++ b/docs/resources/roadmap-and-release-notes.mdx @@ -12,10 +12,10 @@ rss: true ## March 27 - Write API Improvements -- Improved overall quality of the models used in the write API -- Expanded language support to Japanese (`JA`), Korean (`KO`) and (simplified) Chinese (`ZH` or `zh-Hans`) -- Expanded support of writing styles and tones to Spanish (`ES`), Italian (`IT`), French (`FR`), Portuguese (`pt-PT`) and Brazilian Portuguese (`pt-BR`) -- Allow sending texts in multiple source languages in the same request when no `target_lang` is set (similar to translate) +- Improved overall quality of the models used in [DeepL API for Write](/api-reference/improve-text/) +- Expanded Write `target_lang` support to Japanese (`JA`), Korean (`KO`) and (simplified) Chinese (`ZH` or `zh-Hans`) +- Expanded Write support for `writing_style` and `tone` to Spanish (`ES`), Italian (`IT`), French (`FR`), Portuguese (`pt-PT`) and Brazilian Portuguese (`pt-BR`) +- Allow sending Write texts in multiple source languages in the same request when no `target_lang` is set ## March 26 - Expanded Style Rules API - Added 5 new endpoints for style rule list operations: `POST /v3/style_rules`, `GET /v3/style_rules/{style_id}`, `PATCH /v3/style_rules/{style_id}`, `DELETE /v3/style_rules/{style_id}`, and `PUT /v3/style_rules/{style_id}/configured_rules`. From a82dffe753020b52e5122dbcc6d8043b43e70d5c Mon Sep 17 00:00:00 2001 From: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> Date: Fri, 27 Mar 2026 12:10:37 -0400 Subject: [PATCH 4/7] nitpick --- docs/resources/roadmap-and-release-notes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/roadmap-and-release-notes.mdx b/docs/resources/roadmap-and-release-notes.mdx index d1aaee6..e17630b 100644 --- a/docs/resources/roadmap-and-release-notes.mdx +++ b/docs/resources/roadmap-and-release-notes.mdx @@ -13,7 +13,7 @@ rss: true ## March 27 - Write API Improvements - Improved overall quality of the models used in [DeepL API for Write](/api-reference/improve-text/) -- Expanded Write `target_lang` support to Japanese (`JA`), Korean (`KO`) and (simplified) Chinese (`ZH` or `zh-Hans`) +- Expanded Write `target_lang` support to Japanese (`JA`), Korean (`KO`) and simplified Chinese (`ZH` or `zh-Hans`) - Expanded Write support for `writing_style` and `tone` to Spanish (`ES`), Italian (`IT`), French (`FR`), Portuguese (`pt-PT`) and Brazilian Portuguese (`pt-BR`) - Allow sending Write texts in multiple source languages in the same request when no `target_lang` is set From b3d34fe54654abd9dc2361f78ddb8959b18c9667 Mon Sep 17 00:00:00 2001 From: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> Date: Fri, 27 Mar 2026 14:28:28 -0400 Subject: [PATCH 5/7] Apply suggestion from @shirgoldbird --- api-reference/improve-text.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/improve-text.mdx b/api-reference/improve-text.mdx index 83b03ab..d15f70e 100644 --- a/api-reference/improve-text.mdx +++ b/api-reference/improve-text.mdx @@ -62,7 +62,7 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested. Each of the parameter values may contain multiple sentences. - The language of the improved text. A list of supported languages have not yet been added to the `/languages` endpoint. As of March 2026, the following languages are supported: + The language of the improved text. A list of supported languages have not yet been added to the `/languages` endpoint. Currently, the following languages are supported: * `de` (German) * `en-GB` (British English) From e5df32b48fadf92a03d9e909513e7c3d9f792312 Mon Sep 17 00:00:00 2001 From: Jan Ebbing Date: Mon, 30 Mar 2026 11:51:17 +0100 Subject: [PATCH 6/7] review comment: update write target languages --- api-reference/openapi.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml index 870ad50..8e1d517 100644 --- a/api-reference/openapi.yaml +++ b/api-reference/openapi.yaml @@ -5068,9 +5068,13 @@ components: - es - fr - it + - ja + - ko - pt - pt-BR - pt-PT + - zh + - zh-Hans example: de UsageResponse: type: object From 88fa09d1db1542050ff522b683934c4acadbda62 Mon Sep 17 00:00:00 2001 From: Jan Ebbing Date: Mon, 30 Mar 2026 11:52:14 +0100 Subject: [PATCH 7/7] nit: fix casing --- api-reference/improve-text.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/improve-text.mdx b/api-reference/improve-text.mdx index d15f70e..0b9898c 100644 --- a/api-reference/improve-text.mdx +++ b/api-reference/improve-text.mdx @@ -74,7 +74,7 @@ curl -X POST 'https://api.deepl.com/v2/write/rephrase' \ * `ko` (Korean) * `pt-BR` (Brazilian Portuguese) * `pt-PT` (Portuguese) - * `ZH`/`zh-Hans` (simplified Chinese) + * `zh`/`zh-Hans` (simplified Chinese) The language of the source texts sent in the `text` parameter must match the target language (translating and improving text simultaneously is not yet supported).