# Request text improvement

**POST /v2/write/rephrase**




## Servers
- DeepL API Pro: https://api.deepl.com (DeepL API Pro)
- DeepL API Free: https://api-free.deepl.com (DeepL API Free)


## Authentication methods
- Auth header


## Parameters



### Body: application/json (object)

- **text** (array[string])
  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** (string)
  The language for the text improvement. Options currently available:
   * `de` - German
   * `en` - English (unspecified variant, defaults to `en-US`)
   * `en-GB` - English (British)
   * `en-US` - English (American)
   * `es` - Spanish
   * `fr` - French
   * `it` - Italian
   * `pt` - Portuguese (unspecified variant, defaults to `pt-PT`)
   * `pt-BR` - Portuguese (Brazilian)
   * `pt-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese)

- **writing_style** (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.

- **tone** (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.



## Responses
### 200
Successful text improvement.
#### Headers

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### Body: application/json (object)
- **improvements** (array[object])



[Powered by Bump.sh](https://bump.sh)