chore: update OpenAPI JSON files from YAML sources

Author: daniel-jones-dev

api-reference/openapi.json

@@ -585,7 +585,7 @@
                     "example": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7"
                   },
                   "style_id": {
-                    "description": "Specify the [style rule list](/api-reference/style-rules) to use for the translation. \n\n**Important:**  The target language has to match the language of the style rule list. \n\n**Note:** Any request with the `style_id` parameter enabled will use `quality_optimized` models. Requests combining `style_id` and `model_type: latency_optimized` will be rejected.",
+                    "description": "Specify the [style rule list](/api-reference/style-rules) to use for the translation.\n\n**Important:**  The target language has to match the language of the style rule list.\n\n**Note:** Any request with the `style_id` parameter enabled will use `quality_optimized` models. Requests combining `style_id` and `model_type: latency_optimized` will be rejected.",
                     "type": "string",
                     "example": "7ff9bfd6-cd85-4190-8503-d6215a321519"
                   },
@@ -1220,11 +1220,12 @@
     },
     "/v2/glossary-language-pairs": {
       "get": {
+        "deprecated": true,
         "tags": [
           "ManageGlossaries"
         ],
         "summary": "List Language Pairs Supported by Glossaries",
-        "description": "Retrieve the list of language pairs supported by the glossary feature.",
+        "description": "**Deprecated.** Use `GET /v3/languages?resource=glossary` instead, which returns per-language\navailability including source and target roles.\n\nRetrieve the list of language pairs supported by the glossary feature.",
         "operationId": "listGlossaryLanguages",
         "responses": {
           "200": {
@@ -2623,11 +2624,13 @@
     },
     "/v2/languages": {
       "get": {
+        "deprecated": true,
         "tags": [
           "MetaInformation"
         ],
         "summary": "Retrieve Supported Languages",
-        "operationId": "getLanguages",
+        "description": "**Deprecated.** Use `GET /v3/languages?resource=translate_text` (or the appropriate resource)\ninstead. See the [migration guide](https://developers.deepl.com/api-reference/languages/migrate-from-v2-languages)\nfor details.",
+        "operationId": "getLanguagesV2",
         "parameters": [
           {
             "name": "type",
@@ -2864,10 +2867,8 @@
     "/v3/languages/resources": {
       "get": {
         "tags": [
-          "MetaInformation",
-          "beta"
+          "MetaInformation"
         ],
-        "x-beta": true,
         "summary": "Retrieve Language Resources",
         "operationId": "getLanguageResources",
         "description": "Returns all DeepL API resources and the features they support.\n\nFor each feature, the response indicates which languages must support it for the feature to be\navailable — source only (`needs_source_support`), target only (`needs_target_support`), or both.\nThis allows clients to determine feature availability for a language pair by checking the\nappropriate language's `features` object returned by `GET /v3/languages`.",
@@ -3014,10 +3015,8 @@
     "/v3/languages": {
       "get": {
         "tags": [
-          "MetaInformation",
-          "beta"
+          "MetaInformation"
         ],
-        "x-beta": true,
         "summary": "Retrieve Languages",
         "operationId": "getLanguages",
         "description": "Returns languages supported by the specified DeepL API resource. Each language indicates whether it can\nbe used as a source language, a target language, or both, along with the features it supports for that\nresource.",
@@ -4786,7 +4785,7 @@
     "securitySchemes": {
       "auth_header": {
         "type": "apiKey",
-        "description": "Authentication with `Authorization` header and  `DeepL-Auth-Key` authentication scheme. Example:  `DeepL-Auth-Key <api-key>`\n",
+        "description": "Authentication with `Authorization` header and `DeepL-Auth-Key` authentication scheme. Example: `DeepL-Auth-Key <api-key>`\n",
         "name": "Authorization",
         "in": "header",
         "x-default": "DeepL-Auth-Key "
@@ -6562,7 +6561,7 @@
         }
       },
       "Formality": {
-        "description": "Sets whether the translated text should lean towards formal or informal language.\nThis feature is only available for certain target languages. Setting this parameter \nwith a target language that does not support formality will fail, unless one of the \n`prefer_...` options are used.\nPossible options are:\n  * `default` (default)\n  * `more` - for a more formal language\n  * `less` - for a more informal language\n  * `prefer_more` - for a more formal language if available, otherwise fallback to default formality\n  * `prefer_less` - for a more informal language if available, otherwise fallback to default formality",
+        "description": "Sets whether the translated text should lean towards formal or informal language.\nThis feature is only available for certain target languages. Setting this parameter\nwith a target language that does not support formality will fail, unless one of the\n`prefer_...` options are used.\nPossible options are:\n  * `default` (default)\n  * `more` - for a more formal language\n  * `less` - for a more informal language\n  * `prefer_more` - for a more formal language if available, otherwise fallback to default formality\n  * `prefer_less` - for a more informal language if available, otherwise fallback to default formality",
         "type": "string",
         "enum": [
           "default",
@@ -6827,12 +6826,12 @@
         }
       },
       "OutlineDetectionOption": {
-        "description": "Disable the automatic detection of XML structure by setting the `outline_detection` parameter \nto `false` and selecting the tags that should be considered structure tags. This will split sentences \nusing the `splitting_tags` parameter.",
+        "description": "Disable the automatic detection of XML structure by setting the `outline_detection` parameter\nto `false` and selecting the tags that should be considered structure tags. This will split sentences\nusing the `splitting_tags` parameter.",
         "type": "boolean",
         "default": true
       },
       "OutlineDetectionOptionStr": {
-        "description": "Disable the automatic detection of XML structure by setting the `outline_detection` parameter \nto `false` and selecting the tags that should be considered structure tags. This will split sentences \nusing the `splitting_tags` parameter.",
+        "description": "Disable the automatic detection of XML structure by setting the `outline_detection` parameter\nto `false` and selecting the tags that should be considered structure tags. This will split sentences\nusing the `splitting_tags` parameter.",
         "type": "string",
         "default": "1",
         "enum": [
@@ -6855,12 +6854,12 @@
         }
       },
       "PreserveFormattingOption": {
-        "description": "Sets whether the translation engine should respect the original formatting, even if it would usually \ncorrect some aspects.",
+        "description": "Sets whether the translation engine should respect the original formatting, even if it would usually\ncorrect some aspects.",
         "type": "boolean",
         "default": false
       },
       "PreserveFormattingOptionStr": {
-        "description": "Sets whether the translation engine should respect the original formatting, even if it would usually \ncorrect some aspects.",
+        "description": "Sets whether the translation engine should respect the original formatting, even if it would usually\ncorrect some aspects.",
         "type": "string",
         "enum": [
           "0",
@@ -6869,11 +6868,11 @@
         "default": "0"
       },
       "ShowBilledCharacters": {
-        "description": "When true, the response will include the billed_characters parameter, giving the \nnumber of characters from the request that will be counted by DeepL for billing purposes.",
+        "description": "When true, the response will include the billed_characters parameter, giving the\nnumber of characters from the request that will be counted by DeepL for billing purposes.",
         "type": "boolean"
       },
       "SplitSentencesOption": {
-        "description": "Sets whether the translation engine should first split the input into sentences. \n\nPossible values are:\n  * 0 - no splitting at all, whole input is treated as one sentence\n  * 1 (default when tag_handling is not set to html) - splits on punctuation and on newlines\n  * nonewlines (default when tag_handling=html) - splits on punctuation only, ignoring newlines",
+        "description": "Sets whether the translation engine should first split the input into sentences.\n\nPossible values are:\n  * 0 - no splitting at all, whole input is treated as one sentence\n  * 1 (default when tag_handling is not set to html) - splits on punctuation and on newlines\n  * nonewlines (default when tag_handling=html) - splits on punctuation only, ignoring newlines",
         "type": "string",
         "enum": [
           "0",
@@ -6885,7 +6884,7 @@
       },
       "SourceLanguage": {
         "type": "string",
-        "description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to\ndetect the language of the text and translate it.\n\nFor the full list of supported source languages, see [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) or query the [`GET /v3/languages` endpoint](https://developers.deepl.com/api-reference/languages/retrieve-supported-languages-by-resource) (beta).",
+        "description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to\ndetect the language of the text and translate it.\n\nFor the full list of supported source languages, see [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) or query the [`GET /v3/languages` endpoint](https://developers.deepl.com/api-reference/languages/retrieve-supported-languages-by-resource).",
         "example": "EN"
       },
       "TranslationMemory": {
@@ -7059,7 +7058,7 @@
       },
       "TargetLanguage": {
         "type": "string",
-        "description": "The language into which the text should be translated.\n\nFor the full list of supported target languages, see [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) or query the [`GET /v3/languages` endpoint](https://developers.deepl.com/api-reference/languages/retrieve-supported-languages-by-resource) (beta).",
+        "description": "The language into which the text should be translated.\n\nFor the full list of supported target languages, see [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) or query the [`GET /v3/languages` endpoint](https://developers.deepl.com/api-reference/languages/retrieve-supported-languages-by-resource).",
         "example": "DE"
       },
       "TargetLanguageWrite": {