docs(document): restore enable_watermark for POST /v2/document

api-reference/openapi.json

@@ -1077,6 +1077,14 @@
                     "file": "@document.docx"
                   }
                 },
+                "Watermark": {
+                  "summary": "Adding a \"Translated by DeepL\" watermark (docx/pdf only)",
+                  "value": {
+                    "target_lang": "DE",
+                    "file": "@document.pdf",
+                    "enable_watermark": true
+                  }
+                },
                 "Glossary": {
                   "summary": "Using a Glossary",
                   "value": {
@@ -1169,6 +1177,11 @@
                   "translation_memory_threshold": {
                     "$ref": "#/components/schemas/TranslationMemoryThreshold"
                   },
+                  "enable_watermark": {
+                    "description": "When `true`, adds a \"Translated by DeepL\" watermark to the translated document.\n\nOnly supported for `docx` and `pdf` output. For all other output formats the parameter is ignored and the document is returned without a watermark.",
+                    "type": "boolean",
+                    "default": false
+                  },
                   "enable_beta_languages": {
                     "description": "This parameter is maintained for backward compatibility and has no effect.",
                     "type": "boolean",

api-reference/openapi.yaml

@@ -827,6 +827,12 @@ paths:
                 value:
                   target_lang: DE
                   file: '@document.docx'
+              Watermark:
+                summary: Adding a "Translated by DeepL" watermark (docx/pdf only)
+                value:
+                  target_lang: DE
+                  file: '@document.pdf'
+                  enable_watermark: true
               Glossary:
                 summary: Using a Glossary
                 value:
@@ -925,6 +931,13 @@ paths:
                   $ref: '#/components/schemas/TranslationMemoryId'
                 translation_memory_threshold:
                   $ref: '#/components/schemas/TranslationMemoryThreshold'
+                enable_watermark:
+                  description: |-
+                    When `true`, adds a "Translated by DeepL" watermark to the translated document.
+
+                    Only supported for `docx` and `pdf` output. For all other output formats the parameter is ignored and the document is returned without a watermark.
+                  type: boolean
+                  default: false
                 enable_beta_languages:
                   description: |-
                     This parameter is maintained for backward compatibility and has no effect.

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

@@ -13,6 +13,11 @@ rss: true
 ## July 16 - Combined Status Page
 - DeepL now publishes a single [status page](https://www.deeplstatus.com) covering all services, with a dedicated [API view](https://www.deeplstatus.com/?tab=api) for real-time API status and incidents.
 
+## July 14 - Watermarking for Document Translation
+- [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) now accepts an `enable_watermark` parameter. When set to `true`, a "Translated by DeepL" watermark is applied to the translated document.
+- Supported for `docx` and `pdf` output only; the parameter is ignored for all other formats.
+- See the [document translation](/api-reference/document#request-body-descriptions) overview page for parameter details.
+
 ## July 7 - New Document Formats and Higher File Size Limits
 - [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) now supports five additional file formats: `idml` (Adobe InDesign), `xml`, `json`, `dita` (DITA topics), and `mif` (Adobe FrameMaker).
 - XLIFF support has been expanded to versions 1.2, 2.0, and 2.1 (previously 2.1 only).