---
title: "Improve text"
method: POST
path: "/v2/write/rephrase"
tags: ["RephraseText"]
---

# Improve text

`POST /v2/write/rephrase`

## Request body

- object
  - `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` 'de' | 'en' | 'en-GB' | 'en-US' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'pt' | 'pt-BR' | 'pt-PT' | 'zh' | 'zh-Hans' — The language for the text improvement.
  - `writing_style` 'academic' | 'business' | 'casual' | 'default' | 'simple' | 'prefer_academic' | 'prefer_business' | 'prefer_casual' | 'prefer_simple' — 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` 'confident' | 'default' | 'diplomatic' | 'enthusiastic' | 'friendly' | 'prefer_confident' | 'prefer_diplomatic' | 'prefer_enthusiastic' | 'prefer_friendly' — 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.

## Response `200`

Successful text improvement.

- object
  - `improvements` object[]
    - `detected_source_language` string — The language detected in the source text.
    - `target_language` string — The target language specified by the request.
    - `text` string — The improved text.

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `403` — 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.
- `413` — The request size exceeds the limit.
- `415` — Unsupported Content-Type. Use `application/json` or `application/x-www-form-urlencoded`.
- `429` — Too many requests. Please wait and resend your request.
- `456` — Quota exceeded. The character limit has been reached.
- `500` — Internal error.
- `504` — Resource currently unavailable. Try again later.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)