Skip to content

Commit 5515744

Browse files
author
Daniel Jones
authored
Merge pull request #326 from DeepLcom/v3-langs/add-note-about-removing-langs
docs(languages): note that languages may be removed from default response
2 parents dfb6ced + 3a211c4 commit 5515744

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

api-reference/languages/retrieve-supported-languages-by-product.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -205,6 +205,10 @@ The v3 language endpoints are designed to be forward-compatible:
205205
- New languages will be added as DeepL support expands
206206
- Existing fields will not be removed or changed in backwards-incompatible ways
207207

208+
In rare cases, a language may be removed from the default response (for example, if it moves from stable
209+
to beta). When this happens, it will still be accessible via `?include=beta`. We aim to avoid this, but
210+
build your integration to handle languages disappearing from the response gracefully.
211+
208212
<Info>
209213
Build your integration to gracefully handle new BCP 47 `lang` codes and new values in the `features` array. Do not hardcode assumptions about the format of language codes -- see [Language codes follow BCP 47](/docs/resources/language-release-process#language-codes-follow-bcp-47) for details.
210214
</Info>

0 commit comments

Comments
 (0)