---
title: "TextImprovementsByTextList (DeepL)"
description: "Text List Improvements"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/deepl/DeepL.Write.TextImprovementsByTextList
original: https://documentation.invantive.eu/en/datamodels/deepl/DeepL.Write.TextImprovementsByTextList
updated: 2026-11-01T16:36:06Z
license: https://documentation.invantive.eu/en/
---

# TextImprovementsByTextList: DeepL Text List Improvements

`read only` `REST`

- Catalog: `DeepL`
- Schema: `Write`
- Label: Text List Improvements

Can only retrieve data.

## Summary

The text rewritten for fluency, optionally in a writing style or tone. Billed per character on every execution.

## API Source

- Endpoint: `/v2/write/rephrase`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 31 |

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `target_lang` | `varchar2` | [ ] |  | The language of the result, such as en-GB or de; when absent the language of the text. |
| `text_list` | `clob` | [x] |  | JSON array of texts, or of objects with text and optionally key. |
| `tone` | `varchar2` | [ ] |  | confident, default, diplomatic, enthusiastic or friendly, optionally prefixed by prefer_. |
| `writing_style` | `varchar2` | [ ] |  | academic, business, casual, default or simple, optionally prefixed by prefer_. |

## Table Columns

The columns of the table `TextImprovementsByTextList` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `detected_source_language` | `varchar2` | itgen_dpl_detected_source_language | [ ] | filters on the platform, writable | The language detected in the text. |
| `improved_text` | `varchar2` | itgen_dpl_improved_text | [ ] | filters on the platform, writable | The improved text. |
| `key` | `varchar2` | itgen_dpl_key | [ ] | filters on the platform, writable | The key of the element in the text list, returned unchanged. |
| `ordinal` | `int32` | itgen_dpl_ordinal | [x] | filters on the platform, writable | The position of the element in the text list, starting at 1. |
| `request_ordinal` | `int32` | itgen_dpl_request_ordinal | [x] | filters on the platform, writable | The number of the request the element was sent in, starting at 1. |
| `target_language` | `varchar2` | itgen_dpl_target_language | [ ] | filters on the platform, writable | The language of the result. |
| `text` | `varchar2` | itgen_dpl_text | [ ] | filters on the platform, writable | The text as sent. |

