Clarity around language codes which include a country code

[morsssss]

1. I believe glossary/dictionary endpoints ignore country codes, but I don't think we spell this out.
2. Currently we require country codes for language codes where we support variants, but just in client libraries. As in, you can't translate to pt using Python, just pt-PT or pt-BR. But you can translate to pt using an HTTP request. I think this situation is suboptimal, but we should at least document it and explain the reasoning (we want to encourage people to specify their language variant so that they get translations that most optimally match expectations).

[BriannaDelgado]

For 1) we do have this blurb on the glossary overview page https://developers.deepl.com/api-reference/multilingual-glossaries#language-variants but I believe it's the only place atm. We could reuse the same language if we want to add it somewhere else

[morsssss]

That’s exactly it! This shouldn’t just be mentioned on a glossaries page. Ben

…

On Tue, Dec 23, 2025 at 7:57 AM Brianna Delgado ***@***.***> wrote: *BriannaDelgado* left a comment (DeepL/api-docs#207) <#207 (comment)> For 1) we do have this blurb on the glossary overview page https://developers.deepl.com/api-reference/multilingual-glossaries#language-variants but I believe it's the only place atm. We could reuse the same language if we want to add it somewhere else — Reply to this email directly, view it on GitHub <#207 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AHAOP2RQB6IIGTYEXGCIO3D4DFJ4JAVCNFSM6AAAAACPZARI7CVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMOBWHEZDQOBQGU> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[morsssss]

And that blurb only refers to glossaries.

…

On Wed, Dec 31, 2025 at 12:04 PM Ben Morss ***@***.***> wrote: That’s exactly it! This shouldn’t just be mentioned on a glossaries page. Ben On Tue, Dec 23, 2025 at 7:57 AM Brianna Delgado ***@***.***> wrote: > *BriannaDelgado* left a comment (DeepL/api-docs#207) > <#207 (comment)> > > For 1) we do have this blurb on the glossary overview page > https://developers.deepl.com/api-reference/multilingual-glossaries#language-variants > but I believe it's the only place atm. We could reuse the same language if > we want to add it somewhere else > > — > Reply to this email directly, view it on GitHub > <#207 (comment)>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/AHAOP2RQB6IIGTYEXGCIO3D4DFJ4JAVCNFSM6AAAAACPZARI7CVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMOBWHEZDQOBQGU> > . > You are receiving this because you authored the thread.Message ID: > ***@***.***> >