docs(openapi): document style_id, translation_memory_id, and translation_memory_threshold on POST /v2/document

Bring document translation in line with text translation by documenting
the new style_id, translation_memory_id, and translation_memory_threshold
parameters on POST /v2/document, regenerating openapi.json, and adding a
changelog entry.

Author: Maxim Brunnmeier

api-reference/openapi.json

@@ -1050,6 +1050,25 @@
                     "file": "@document.docx",
                     "glossary_id": "[yourGlossaryId]"
                   }
+                },
+                "StyleRule": {
+                  "summary": "Using a Style Rule List",
+                  "value": {
+                    "source_lang": "EN",
+                    "target_lang": "DE",
+                    "file": "@document.docx",
+                    "style_id": "[yourStyleId]"
+                  }
+                },
+                "TranslationMemory": {
+                  "summary": "Using a Translation Memory",
+                  "value": {
+                    "source_lang": "EN",
+                    "target_lang": "DE",
+                    "file": "@document.docx",
+                    "translation_memory_id": "[yourTranslationMemoryId]",
+                    "translation_memory_threshold": 75
+                  }
                 }
               },
               "schema": {
@@ -1084,6 +1103,17 @@
                   "glossary_id": {
                     "$ref": "#/components/schemas/GlossaryId"
                   },
+                  "style_id": {
+                    "description": "Specify the [style rule list](/api-reference/style-rules) to use for the translation.\n\n**Important:** The target language has to match the language of the style rule list.",
+                    "type": "string",
+                    "example": "7ff9bfd6-cd85-4190-8503-d6215a321519"
+                  },
+                  "translation_memory_id": {
+                    "$ref": "#/components/schemas/TranslationMemoryId"
+                  },
+                  "translation_memory_threshold": {
+                    "$ref": "#/components/schemas/TranslationMemoryThreshold"
+                  },
                   "enable_beta_languages": {
                     "description": "This parameter is maintained for backward compatibility and has no effect.",
                     "type": "boolean",

api-reference/openapi.yaml

@@ -787,6 +787,21 @@ paths:
                   target_lang: DE
                   file: '@document.docx'
                   glossary_id: '[yourGlossaryId]'
+              StyleRule:
+                summary: Using a Style Rule List
+                value:
+                  source_lang: EN
+                  target_lang: DE
+                  file: '@document.docx'
+                  style_id: '[yourStyleId]'
+              TranslationMemory:
+                summary: Using a Translation Memory
+                value:
+                  source_lang: EN
+                  target_lang: DE
+                  file: '@document.docx'
+                  translation_memory_id: '[yourTranslationMemoryId]'
+                  translation_memory_threshold: 75
             schema:
               type: object
               required:
@@ -823,6 +838,17 @@ paths:
                   $ref: '#/components/schemas/Formality'
                 glossary_id:
                   $ref: '#/components/schemas/GlossaryId'
+                style_id:
+                  description: |-
+                    Specify the [style rule list](/api-reference/style-rules) to use for the translation.
+
+                    **Important:** The target language has to match the language of the style rule list.
+                  type: string
+                  example: 7ff9bfd6-cd85-4190-8503-d6215a321519
+                translation_memory_id:
+                  $ref: '#/components/schemas/TranslationMemoryId'
+                translation_memory_threshold:
+                  $ref: '#/components/schemas/TranslationMemoryThreshold'
                 enable_beta_languages:
                   description: |-
                     This parameter is maintained for backward compatibility and has no effect.

docs/resources/roadmap-and-release-notes.mdx

@@ -15,6 +15,11 @@ rss: true
 - The Ruby client library [`deepl-rb`](https://github.com/DeepLcom/deepl-rb) v3.8.0 now accepts an `additional_headers` argument on `translate` calls, so you can send `X-DeepL-Reporting-Tag` for usage reporting.
 - See [Sending Custom Reporting Tags with Client Libraries](/docs/learning-how-tos/cookbook/sending-custom-reporting-tags-from-client-libraries) for the updated Ruby snippet.
 
+## May 26 - Style Rules and Translation Memories for Document Translation
+- [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) now accepts `style_id`, `translation_memory_id`, and `translation_memory_threshold`, bringing document translation in line with the parameters already available on text translation.
+- `style_id` applies a configured [style rule list](/api-reference/style-rules) to the document translation.
+- `translation_memory_id` and `translation_memory_threshold` work as on text translation: pass a translation memory ID to apply stored translations, and set a threshold (0-100) to control how closely source text must match a stored segment. See the [translation memories guide](/docs/learning-how-tos/examples-and-guides/how-to-use-translation-memories).
+
 ## May 26 - API Usage Logger Cookbook
 - Added a new cookbook, [API Usage Logger](/docs/learning-how-tos/cookbook/api-usage-logger), showing how to capture per-request DeepL API usage data (billed characters, language pairs, reporting tags, API keys, errors) and explore it through a local Streamlit dashboard.
 - Source code on GitHub: [`DeepLcom/deepl-api-usage-logger`](https://github.com/DeepLcom/deepl-api-usage-logger).