Skip to content

Conversation

@Parvati-DeepL
Copy link
Collaborator

edited 2 files (glossaries and style rules) to be more explicit about api-us endpoint not retrieving those created in UI.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds documentation clarifying that clients using the api-us.deepl.com endpoint cannot access glossaries or style rules created in the UI, addressing an important API limitation for US data center users.

Key Changes:

  • Added explicit notice in both glossaries and style rules documentation about api-us.deepl.com endpoint limitations
  • Clarified that UI-created resources are not accessible via the US API endpoint

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
api-reference/style-rules.mdx Added sentence explaining that api-us.deepl.com endpoint users cannot access UI-created style rules
api-reference/multilingual-glossaries.mdx Added Info callout box explaining that api-us.deepl.com endpoint users cannot access UI-created glossaries

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Member

@shirgoldbird shirgoldbird left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nits


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.

<Info>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would this section be better further up in the doc under ## Creating glossaries?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found the beginning of this language right above creating glossaries, bottom of overview section so adding this there.

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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Co-authored-by: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com>
Co-authored-by: Shir Goldberg <3937986+shirgoldbird@users.noreply.github.com>
@Parvati-DeepL Parvati-DeepL merged commit 56ca30b into main Dec 4, 2025
2 checks passed
@Parvati-DeepL Parvati-DeepL deleted the parvatiupdates-new branch December 4, 2025 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants