Skip to content

feat: Add all supported languages to source_lang and target_lang specs #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
daniel-jones-dev merged 2 commits into from
Feb 18, 2026
Merged

feat: Add all supported languages to source_lang and target_lang specs #43

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
980b5bd
feat: Add all supported languages to Translate API source_lang and ta…
jason-gardella-deepl Feb 17, 2026
3f6bc66
refactor: Merge duplicate SourceLanguageText schema into SourceLanguage
jason-gardella-deepl Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ typos, schema fixes, or adding examples.
* Renamed `SourceDataChunk` and `EndOfSourceData` to `SourceMediaChunk` and `EndOfSourceMedia`
*
* Fixes the usage endpoint response object name. Should be `key_usages` and `key_and_day_usages` instead of `grouped_usage`
* Add all supported languages to Translate API `source_lang` and `target_lang` specs
* Merge redundant `SourceLanguageText` and `TargetLanguageText` schemas into `SourceLanguage` and `TargetLanguage` to eliminate duplication

### Deprecated
* Removed the `openapi_gitbook.yaml` file due to redundancy. Please use `openapi.yaml` going forward
Expand Down
259 changes: 172 additions & 87 deletions openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,10 +83,10 @@
}
},
"source_lang": {
"$ref": "#/components/schemas/SourceLanguageText"
"$ref": "#/components/schemas/SourceLanguage"
},
"target_lang": {
"$ref": "#/components/schemas/TargetLanguageText"
"$ref": "#/components/schemas/TargetLanguage"
},
"context": {
"$ref": "#/components/schemas/Context"
Expand Down Expand Up @@ -206,10 +206,10 @@
}
},
"source_lang": {
"$ref": "#/components/schemas/SourceLanguageText"
"$ref": "#/components/schemas/SourceLanguage"
},
"target_lang": {
"$ref": "#/components/schemas/TargetLanguageText"
"$ref": "#/components/schemas/TargetLanguage"
},
"context": {
"$ref": "#/components/schemas/Context"
Expand Down Expand Up @@ -5549,78 +5549,122 @@
},
"SourceLanguage": {
"type": "string",
"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.",
"enum": [
"AR",
"BG",
"CS",
"DA",
"DE",
"EL",
"EN",
"ES",
"ET",
"FI",
"FR",
"HU",
"ID",
"IT",
"JA",
"KO",
"LT",
"LV",
"NB",
"NL",
"PL",
"PT",
"RO",
"RU",
"SK",
"SL",
"SV",
"TR",
"UK",
"ZH"
],
"example": "EN"
},
"SourceLanguageText": {
"type": "string",
"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\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\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.",
"description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.",
"enum": [
"ACE",
"AF",
"AN",
"AR",
"AS",
"AY",
"AZ",
"BA",
"BE",
"BG",
"BHO",
"BN",
"BR",
"BS",
"CA",
"CEB",
"CKB",
"CS",
"CY",
"DA",
"DE",
"EL",
"EN",
"EO",
"ES",
"ET",
"EU",
"FA",
"FI",
"FR",
"GA",
"GL",
"GN",
"GOM",
"GU",
"HA",
"HE",
"HI",
"HR",
"HT",
"HU",
"HY",
"ID",
"IG",
"IS",
"IT",
"JA",
"JV",
"KA",
"KK",
"KMR",
"KO",
"KY",
"LA",
"LB",
"LMO",
"LN",
"LT",
"LV",
"MAI",
"MG",
"MI",
"MK",
"ML",
"MN",
"MR",
"MS",
"MT",
"MY",
"NB",
"NE",
"NL",
"OC",
"OM",
"PA",
"PAG",
"PAM",
"PL",
"PRS",
"PS",
"PT",
"QU",
"RO",
"RU",
"SA",
"SCN",
"SK",
"SL",
"SQ",
"SR",
"ST",
"SU",
"SV",
"SW",
"TA",
"TE",
"TG",
"TH",
"TK",
"TL",
"TN",
"TR",
"TS",
"TT",
"UK",
"UR",
"UZ",
"VI",
"ZH"
"WO",
"XH",
"YI",
"YUE",
"ZH",
"ZU"
],
"example": "EN"
},
Expand Down Expand Up @@ -5799,88 +5843,129 @@
},
"TargetLanguage": {
"type": "string",
"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 * `ES-419` - Spanish (Latin American)\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)",
"enum": [
"AR",
"BG",
"CS",
"DA",
"DE",
"EL",
"EN-GB",
"EN-US",
"ES",
"ES-419",
"ET",
"FI",
"FR",
"HU",
"ID",
"IT",
"JA",
"KO",
"LT",
"LV",
"NB",
"NL",
"PL",
"PT-BR",
"PT-PT",
"RO",
"RU",
"SK",
"SL",
"SV",
"TR",
"UK",
"ZH",
"ZH-HANS",
"ZH-HANT"
],
"example": "DE"
},
"TargetLanguageText": {
"type": "string",
"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 * `ES-419` - Spanish (Latin American)\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HE` - Hebrew\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\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese\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)",
"description": "The language into which the text should be translated.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.",
"enum": [
"ACE",
"AF",
"AN",
"AR",
"AS",
"AY",
"AZ",
"BA",
"BE",
"BG",
"BHO",
"BN",
"BR",
"BS",
"CA",
"CEB",
"CKB",
"CS",
"CY",
"DA",
"DE",
"EL",
"EN",
"EN-GB",
"EN-US",
"EO",
"ES",
"ES-419",
"ET",
"EU",
"FA",
"FI",
"FR",
"GA",
"GL",
"GN",
"GOM",
"GU",
"HA",
"HE",
"HI",
"HR",
"HT",
"HU",
"HY",
"ID",
"IG",
"IS",
"IT",
"JA",
"JV",
"KA",
"KK",
"KMR",
"KO",
"KY",
"LA",
"LB",
"LMO",
"LN",
"LT",
"LV",
"MAI",
"MG",
"MI",
"MK",
"ML",
"MN",
"MR",
"MS",
"MT",
"MY",
"NB",
"NE",
"NL",
"OC",
"OM",
"PA",
"PAG",
"PAM",
"PL",
"PRS",
"PS",
"PT",
"PT-BR",
"PT-PT",
"QU",
"RO",
"RU",
"SA",
"SCN",
"SK",
"SL",
"SQ",
"SR",
"ST",
"SU",
"SV",
"SW",
"TA",
"TE",
"TG",
"TH",
"TK",
"TL",
"TN",
"TR",
"TS",
"TT",
"UK",
"UR",
"UZ",
"VI",
"WO",
"XH",
"YI",
"YUE",
"ZH",
"ZH-HANS",
"ZH-HANT"
"ZH-HANT",
"ZU"
],
"example": "DE"
},
Expand Down
Loading