From 6276770954f6eb7b593f7073459981dd8c6c6285 Mon Sep 17 00:00:00 2001 From: Maxim Brunnmeier Date: Thu, 21 May 2026 11:59:17 +0200 Subject: [PATCH 1/2] docs(openapi): document style_id, translation_memory_id, and translation_memory_threshold on POST /v2/document Reuses the existing TranslationMemoryId and TranslationMemoryThreshold schemas already used by /v2/translate, and adds StyleRule and TranslationMemory request examples alongside the existing Basic and Glossary examples. --- api-reference/openapi.yaml | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml index 107b856..bc72d74 100644 --- a/api-reference/openapi.yaml +++ b/api-reference/openapi.yaml @@ -776,6 +776,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: @@ -812,6 +827,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. From 3207b8304d6945cba0b5d2274151bf6619f687a6 Mon Sep 17 00:00:00 2001 From: Maxim Brunnmeier Date: Tue, 26 May 2026 10:58:08 +0200 Subject: [PATCH 2/2] docs(changelog): note style_id and translation memory params on POST /v2/document --- docs/resources/roadmap-and-release-notes.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/resources/roadmap-and-release-notes.mdx b/docs/resources/roadmap-and-release-notes.mdx index 184a2ae..cefa403 100644 --- a/docs/resources/roadmap-and-release-notes.mdx +++ b/docs/resources/roadmap-and-release-notes.mdx @@ -11,6 +11,11 @@ rss: true +## 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 20 - Custom Tag Usage Analytics - Added [`GET /v2/admin/analytics/custom-tags`](/api-reference/admin-api/organization-usage-analytics) to the Admin API, allowing admins to retrieve usage statistics broken down by custom tags. - Supports `aggregate_by=period` (default) to aggregate usage over the full date range, or `aggregate_by=day` for daily breakdowns.