Skip to main content
POST
/
v2
/
write
/
rephrase
Improve text
curl --request POST \
  --url https://api.deepl.com/v2/write/rephrase \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": [
    "this is a example sentence to imprve"
  ]
}
'
{
  "improvements": [
    {
      "detected_source_language": "en",
      "target_language": "en-US",
      "text": "This is a sample sentence to improve."
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://deepl-c950b784-feat-write-correct-endpoint.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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.

Authorizations

​
Authorization
string
header
default:DeepL-Auth-Key
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Body

​
text
string[]
required

Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested.

​
target_lang
enum<string>

The language for the text improvement.

Available options:
de,
en,
en-GB,
en-US,
es,
fr,
it,
ja,
ko,
pt,
pt-BR,
pt-PT,
zh,
zh-Hans
Example:

"de"

​
writing_style
enum<string>

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.

Available options:
academic,
business,
casual,
default,
simple,
prefer_academic,
prefer_business,
prefer_casual,
prefer_simple
​
tone
enum<string>

Specify the desired tone for your text. The prefer_ prefix allows falling back to the default tone if the language does not yet support tones.

Available options:
confident,
default,
diplomatic,
enthusiastic,
friendly,
prefer_confident,
prefer_diplomatic,
prefer_enthusiastic,
prefer_friendly

Response

200 - application/json

Successful text improvement.

​
improvements
object[]
Minimum array length: 1