Skip to content

Commit 887f031

Browse files
BriannaDelgadoBriannaDelgado
committed
feat: Add new supported languages to code examples
1 parent 5c548ac commit 887f031

3 files changed

Lines changed: 176 additions & 24 deletions

File tree

‎openapi.json‎

Lines changed: 60 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"name": "DeepL - Contact us",
99
"url": "https://www.deepl.com/contact-us"
1010
},
11-
"version": "3.0.2"
11+
"version": "3.2.0"
1212
},
1313
"externalDocs": {
1414
"description": "DeepL Pro - Plans and pricing",
@@ -2071,7 +2071,7 @@
20712071
"MetaInformation"
20722072
],
20732073
"summary": "Retrieve Supported Languages",
2074-
"description": "Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively.\n\nAs of January 2024, Arabic (AR) is supported as a source and target language for text translation, \nbut it is not yet supported for document translation. Therefore, Arabic has not yet been added to \nthe `/languages` endpoint. We will add Arabic to the `/languages` endpoint after document translation \nsupport is added.",
2074+
"description": "Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively.\n\nAs of May 2025, Hebrew (HE), Thai (TH), and Vietnamese (VI) are supported as a source and target language for text translation, \nbut it is not yet supported for document translation. Therefore, they have not yet been added to the `/languages` endpoint. We \nwill add Hebrew, Thai, and Vietnamese to the `/languages` endpoint after document translation support is added.",
20752075
"operationId": "getLanguages",
20762076
"parameters": [
20772077
{
@@ -2127,6 +2127,11 @@
21272127
}
21282128
},
21292129
"example": [
2130+
{
2131+
"language": "AR",
2132+
"name": "Arabic",
2133+
"supports_formality": false
2134+
},
21302135
{
21312136
"language": "BG",
21322137
"name": "Bulgarian",
@@ -2286,6 +2291,11 @@
22862291
"language": "ZH-HANS",
22872292
"name": "Chinese (simplified)",
22882293
"supports_formality": false
2294+
},
2295+
{
2296+
"language": "ZH-HANT",
2297+
"name": "Chinese (traditional)",
2298+
"supports_formality": false
22892299
}
22902300
]
22912301
}
@@ -2621,21 +2631,38 @@
26212631
"type": "string",
26222632
"description": "The language in which the source texts in the glossary are specified.",
26232633
"enum": [
2634+
"ar",
2635+
"bg",
2636+
"cs",
26242637
"da",
26252638
"de",
2639+
"el",
26262640
"en",
26272641
"es",
2642+
"et",
2643+
"fi",
26282644
"fr",
2645+
"he",
2646+
"hu",
2647+
"id",
26292648
"it",
26302649
"ja",
26312650
"ko",
2651+
"lt",
2652+
"lv",
26322653
"nb",
26332654
"nl",
26342655
"pl",
26352656
"pt",
26362657
"ro",
26372658
"ru",
2659+
"sk",
2660+
"sl",
26382661
"sv",
2662+
"th",
2663+
"tr",
2664+
"uk",
2665+
"vi",
26392666
"zh"
26402667
],
26412668
"example": "en"
@@ -2644,21 +2671,38 @@
26442671
"type": "string",
26452672
"description": "The language in which the target texts in the glossary are specified.",
26462673
"enum": [
2674+
"ar",
2675+
"bg",
2676+
"cs",
26472677
"da",
26482678
"de",
2679+
"el",
26492680
"en",
26502681
"es",
2682+
"et",
2683+
"fi",
26512684
"fr",
2685+
"he",
2686+
"hu",
2687+
"id",
26522688
"it",
26532689
"ja",
26542690
"ko",
2691+
"lt",
2692+
"lv",
26552693
"nb",
26562694
"nl",
26572695
"pl",
26582696
"pt",
26592697
"ro",
26602698
"ru",
2699+
"sk",
2700+
"sl",
26612701
"sv",
2702+
"th",
2703+
"tr",
2704+
"uk",
2705+
"vi",
26622706
"zh"
26632707
],
26642708
"example": "de"
@@ -2844,8 +2888,9 @@
28442888
},
28452889
"SourceLanguage": {
28462890
"type": "string",
2847-
"description": "Language of the text to be translated. Options currently available:\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.",
2891+
"description": "Language of the text to be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.",
28482892
"enum": [
2893+
"AR",
28492894
"BG",
28502895
"CS",
28512896
"DA",
@@ -2880,7 +2925,7 @@
28802925
},
28812926
"SourceLanguageText": {
28822927
"type": "string",
2883-
"description": "Language of the text to be translated. Options currently available:\n * `AR` - Arabic [1]\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n[1] Please note that Arabic has not yet been added to the `/languages` endpoint because it does not \nyet support document translation; only text translation is supported for Arabic at this time. When \ndocument translation support is added for Arabic, we will a) remove this note and b) add Arabic to \nthe `/languages` endpoint.",
2928+
"description": "Language of the text to be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HE` - Hebrew [1]\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TH` - Thai [1]\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese [1]\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n[1] Please note that Hebrew, Thai, and Vietnamese have not yet been added to the `/languages` endpoint \nbecause they does not yet support document translation; only text translation is supported for those\nlanguages at this time. When document translation support is added for Hebrew, Thai, and Vietnamese, \nwe will a) remove this note and b) add Hebrew, Thai, and Vietnamese to the `/languages` endpoint.",
28842929
"enum": [
28852930
"AR",
28862931
"BG",
@@ -2893,6 +2938,7 @@
28932938
"ET",
28942939
"FI",
28952940
"FR",
2941+
"HE",
28962942
"HU",
28972943
"ID",
28982944
"IT",
@@ -2909,8 +2955,10 @@
29092955
"SK",
29102956
"SL",
29112957
"SV",
2958+
"TH",
29122959
"TR",
29132960
"UK",
2961+
"VI",
29142962
"ZH"
29152963
],
29162964
"example": "EN"
@@ -3053,8 +3101,9 @@
30533101
},
30543102
"TargetLanguage": {
30553103
"type": "string",
3056-
"description": "The language into which the text should be translated. Options currently available:\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese varieties excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` instead)\n * `ZH-HANS` - Chinese (simplified)",
3104+
"description": "The language into which the text should be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese varieties excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` instead)\n * `ZH-HANS` - Chinese (simplified)\n * `ZH-HANT` - Chinese (traditional)",
30573105
"enum": [
3106+
"AR",
30583107
"BG",
30593108
"CS",
30603109
"DA",
@@ -3086,13 +3135,14 @@
30863135
"TR",
30873136
"UK",
30883137
"ZH",
3089-
"ZH-HANS"
3138+
"ZH-HANS",
3139+
"ZH-HANT"
30903140
],
30913141
"example": "DE"
30923142
},
30933143
"TargetLanguageText": {
30943144
"type": "string",
3095-
"description": "The language into which the text should be translated. Options currently available:\n * `AR` - Arabic [1]\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` or `ZH-HANT` instead)\n * `ZH-HANS` - Chinese (simplified)\n * `ZH-HANT` - Chinese (traditional)\n\n [1] Please note that Arabic and traditional Chinese have not yet been added to the /languages \n endpoint because these languages do not yet support document translation; only text translation \n is supported for Arabic and traditional Chinese at this time. When document translation support \n is added for these languages, we will a) remove this note and b) add the languages to the /languages \n endpoint where appropriate.",
3145+
"description": "The language into which the text should be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HE` - Hebrew [1]\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TH` - Thai [1]\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese [1]\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` or `ZH-HANT` instead)\n * `ZH-HANS` - Chinese (simplified)\n * `ZH-HANT` - Chinese (traditional)\n\n[1] Please note that Hebrew, Thai, and Vietnamese have not yet been added to the `/languages` endpoint \nbecause they does not yet support document translation; only text translation is supported for those\nlanguages at this time. When document translation support is added for Hebrew, Thai, and Vietnamese, \nwe will a) remove this note and b) add Hebrew, Thai, and Vietnamese to the `/languages` endpoint.",
30963146
"enum": [
30973147
"AR",
30983148
"BG",
@@ -3106,6 +3156,7 @@
31063156
"ET",
31073157
"FI",
31083158
"FR",
3159+
"HE",
31093160
"HU",
31103161
"ID",
31113162
"IT",
@@ -3123,8 +3174,10 @@
31233174
"SK",
31243175
"SL",
31253176
"SV",
3177+
"TH",
31263178
"TR",
31273179
"UK",
3180+
"VI",
31283181
"ZH",
31293182
"ZH-HANS",
31303183
"ZH-HANT"

0 commit comments

Comments
 (0)