From 4326dc4b11623eadcccd86776e0b86b1ec336b9b Mon Sep 17 00:00:00 2001 From: Parvati Mani Date: Tue, 2 Dec 2025 10:48:25 -0600 Subject: [PATCH 1/6] added language about api-us --- api-reference/multilingual-glossaries.mdx | 5 +++++ api-reference/style-rules.mdx | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/api-reference/multilingual-glossaries.mdx b/api-reference/multilingual-glossaries.mdx index 5e93ad9..e36b160 100644 --- a/api-reference/multilingual-glossaries.mdx +++ b/api-reference/multilingual-glossaries.mdx @@ -160,6 +160,7 @@ This example creates a modest glossary with two dictionaries. One maps "Hello" i + ## Using `POST /v2/translate` @@ -241,6 +242,10 @@ To use a glossary in a translation request, include its `glossary_id` . You must Use this endpoint to list all your glossaries, basic information about each glossary's dictionaries, and each glossary's name and creation time. The response will not include any dictionary entries. + +Glossaries can also be created in the UI and retreived through API, but both [style rules](./style-rules) and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. + + The example below uses our API Pro endpoint `https://api.deepl.com`. If you're an API Free user, remember to update your requests to use `https://api-free.deepl.com` instead. diff --git a/api-reference/style-rules.mdx b/api-reference/style-rules.mdx index c493ec2..148ce3b 100644 --- a/api-reference/style-rules.mdx +++ b/api-reference/style-rules.mdx @@ -12,7 +12,7 @@ The style rules feature allows you to select a set of rules to apply when transl You can create style rules in the UI at [https://deepl.com/custom-rules](https://deepl.com/custom-rules). -Both style rules and glossaries are unique to each global data center and are not shared between them. +Both style rules and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. ### Get all style rule lists Get all style rules lists and their meta-information. From 760a6da14f173e3e025e6d5b17a097874db98bb3 Mon Sep 17 00:00:00 2001 From: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> Date: Tue, 2 Dec 2025 19:16:52 -0500 Subject: [PATCH 2/6] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- api-reference/multilingual-glossaries.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/multilingual-glossaries.mdx b/api-reference/multilingual-glossaries.mdx index e36b160..a1bf83d 100644 --- a/api-reference/multilingual-glossaries.mdx +++ b/api-reference/multilingual-glossaries.mdx @@ -243,7 +243,7 @@ To use a glossary in a translation request, include its `glossary_id` . You must Use this endpoint to list all your glossaries, basic information about each glossary's dictionaries, and each glossary's name and creation time. The response will not include any dictionary entries. -Glossaries can also be created in the UI and retreived through API, but both [style rules](./style-rules) and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. +Glossaries can also be created in the UI and retrieved through API, but both [style rules](./style-rules) and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. From 8c7f862fdb4c5b3dc302ef7badc2e27ea0b2abd1 Mon Sep 17 00:00:00 2001 From: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> Date: Tue, 2 Dec 2025 20:06:34 -0500 Subject: [PATCH 3/6] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- api-reference/style-rules.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/style-rules.mdx b/api-reference/style-rules.mdx index 148ce3b..2825152 100644 --- a/api-reference/style-rules.mdx +++ b/api-reference/style-rules.mdx @@ -12,7 +12,7 @@ The style rules feature allows you to select a set of rules to apply when transl You can create style rules in the UI at [https://deepl.com/custom-rules](https://deepl.com/custom-rules). -Both style rules and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. +Both style rules and glossaries are unique to each global data center and are not shared between them. Clients using the `api-us.deepl.com` endpoint will not be able to access glossaries or style rules created in the UI at this time. ### Get all style rule lists Get all style rules lists and their meta-information. From 6314c24d7316af26b28fe799471db4b1e10ef9d0 Mon Sep 17 00:00:00 2001 From: Parvati-DeepL Date: Wed, 3 Dec 2025 09:22:16 -0600 Subject: [PATCH 4/6] Update api-reference/multilingual-glossaries.mdx Co-authored-by: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> --- api-reference/multilingual-glossaries.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/multilingual-glossaries.mdx b/api-reference/multilingual-glossaries.mdx index a1bf83d..898df1e 100644 --- a/api-reference/multilingual-glossaries.mdx +++ b/api-reference/multilingual-glossaries.mdx @@ -160,7 +160,6 @@ This example creates a modest glossary with two dictionaries. One maps "Hello" i - ## Using `POST /v2/translate` From b0928be0a3aa3057d4a8de773c4481e40550f7fc Mon Sep 17 00:00:00 2001 From: Parvati-DeepL Date: Wed, 3 Dec 2025 09:24:30 -0600 Subject: [PATCH 5/6] Update api-reference/multilingual-glossaries.mdx Co-authored-by: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com> --- api-reference/multilingual-glossaries.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/multilingual-glossaries.mdx b/api-reference/multilingual-glossaries.mdx index 898df1e..f9a10bd 100644 --- a/api-reference/multilingual-glossaries.mdx +++ b/api-reference/multilingual-glossaries.mdx @@ -242,7 +242,7 @@ To use a glossary in a translation request, include its `glossary_id` . You must Use this endpoint to list all your glossaries, basic information about each glossary's dictionaries, and each glossary's name and creation time. The response will not include any dictionary entries. -Glossaries can also be created in the UI and retrieved through API, but both [style rules](./style-rules) and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. +Both [style rules](./style-rules) and glossaries are unique to each of DeepL's global data centers and are not shared between them. Clients using the `api-us.deepl.com` endpoint will not be able to access glossaries or style rules created in the UI at this time. From ebc4ae08ae1eccb1049450b048e835d35e8363d9 Mon Sep 17 00:00:00 2001 From: Parvati Mani Date: Wed, 3 Dec 2025 09:41:55 -0600 Subject: [PATCH 6/6] clarifying api-us language --- api-reference/multilingual-glossaries.mdx | 9 ++------- api-reference/style-rules.mdx | 2 +- 2 files changed, 3 insertions(+), 8 deletions(-) diff --git a/api-reference/multilingual-glossaries.mdx b/api-reference/multilingual-glossaries.mdx index e36b160..5e57318 100644 --- a/api-reference/multilingual-glossaries.mdx +++ b/api-reference/multilingual-glossaries.mdx @@ -14,7 +14,6 @@ description: "Manage and use DeepL glossaries" - ## Overview The `glossaries` endpoints let you work with [DeepL glossaries](https://support.deepl.com/hc/en-us/articles/360021634540-About-the-glossary), which let you specify specific translations for words or short phrases. Each glossary contains a mapping of source phrases to target phrases. During translation, DeepL intelligently flexes entries to account for case, gender, tense, and other grammar features (if the target language has flexion). @@ -37,7 +36,8 @@ Note that this mapping occurs only in one direction, which is all you need durin | exquisito | delicieux | | mouse | mouse | -Both glossaries and style rules are unique to each global data center and are not shared between them. +Both glossaries and style rules are unique to each of DeepL's global data centers and are not shared between them. Clients using the `api-us.deepl.com` endpoint will not be able to access glossaries or style rules created in the UI at this time. + ## Creating glossaries @@ -160,7 +160,6 @@ This example creates a modest glossary with two dictionaries. One maps "Hello" i - ## Using `POST /v2/translate` @@ -242,10 +241,6 @@ To use a glossary in a translation request, include its `glossary_id` . You must Use this endpoint to list all your glossaries, basic information about each glossary's dictionaries, and each glossary's name and creation time. The response will not include any dictionary entries. - -Glossaries can also be created in the UI and retreived through API, but both [style rules](./style-rules) and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. - - The example below uses our API Pro endpoint `https://api.deepl.com`. If you're an API Free user, remember to update your requests to use `https://api-free.deepl.com` instead. diff --git a/api-reference/style-rules.mdx b/api-reference/style-rules.mdx index 148ce3b..1a32a4a 100644 --- a/api-reference/style-rules.mdx +++ b/api-reference/style-rules.mdx @@ -12,7 +12,7 @@ The style rules feature allows you to select a set of rules to apply when transl You can create style rules in the UI at [https://deepl.com/custom-rules](https://deepl.com/custom-rules). -Both style rules and glossaries are unique to each global data center and are not shared between them. Clients using the ```api-us.deepl.com``` endpoint will not be able to access glossaries or style rules created in the UI at this time. +Both style rules and glossaries are unique to each of DeepL's global data centers and are not shared between them. Clients using the `api-us.deepl.com` endpoint will not be able to access glossaries or style rules created in the UI at this time. ### Get all style rule lists Get all style rules lists and their meta-information.