🌍 Translate Transcripts
You can translate a processed transcription document into one or more additional languages using the Scriptix Documents API.
There are two endpoints available:
/translate– Translate to a single target language/translate-multiple– Translate to multiple languages in one request
⚠️ You must use the same API token that was used to create the original transcription session. Translations are bound to the original
TranscriptSession.
🔐 Required Authentication
All requests must include the proper authentication headers.
| Header | Type | Required | Description |
|---|---|---|---|
Content-Type | string | ✅ | Must be application/json |
X-Zoom-S2T-Key | string | ✅ | Your Batch API token used in the session |
📥 Path Parameters
| Parameter | Description |
|---|---|
session_id | The Transcript Session ID from the original batch job |
document_id | The ID of the document to translate |
🗣️ Translate to a Single Language
Endpoint
POST /api/v3/speech-to-text/session/{sessionId}/document/{document_id}/translate
Request Body
{
"language": "FR",
"filename": "translated-meeting-notes",
"webhook_url": "https://your-domain.com/scriptix-callback",
"webhook_method": "POST",
"webhook_headers": [
"Authorization: YOUR_TOKEN"
],
"copy_webhook_settings": true
}
🌐 Supported Language Codes
Below is the list of supported language codes and the translation services they are available through.
| Code | Language | Service |
|---|---|---|
| BG | Bulgarian | |
| CS | Czech | DeepL |
| DA | Danish | DeepL |
| DE | German | DeepL |
| EL | Greek | DeepL |
| EN-GB | English (British) | DeepL |
| EN-US | English (American) | DeepL |
| EN | English (Default) | DeepL |
| ES | Spanish | DeepL |
| ET | Estonian | DeepL |
| FI | Finnish | DeepL |
| FR | French | DeepL |
| HU | Hungarian | DeepL |
| ID | Indonesian | DeepL |
| IT | Italian | DeepL |
| JA | Japanese | DeepL |
| KO | Korean | DeepL |
| LT | Lithuanian | DeepL |
| LV | Latvian | DeepL |
| NB | Norwegian | DeepL |
| NL | Dutch | DeepL |
| PL | Polish | DeepL |
| PT-BR | Portuguese (Brazilian) | DeepL |
| PT-PT | Portuguese (European) | DeepL |
| PT | Portuguese (Default) | DeepL |
| RO | Romanian | DeepL |
| RU | Russian | DeepL |
| SK | Slovak | DeepL |
| SL | Slovenian | DeepL |
| SV | Swedish | DeepL |
| TR | Turkish | DeepL |
| UK | Ukrainian | DeepL |
| ZH | Chinese | DeepL |
| AR | Arabic | |
| BN | Bengali | |
| CA | Catalan | |
| HR | Croatian | |
| CY | Welsh | |
| FA | Persian | |
| GL | Galician | |
| GA | Irish | |
| GU | Gujarati | |
| HE | Hebrew | |
| HI | Hindi | |
| IS | Icelandic | |
| KN | Kannada | |
| KM | Khmer | |
| LO | Lao | |
| ML | Malayalam | |
| MR | Marathi | |
| MS | Malay | |
| MT | Maltese | |
| MY | Burmese | |
| NE | Nepali | |
| PA | Punjabi | |
| SI | Sinhala | |
| SW | Swahili | |
| TA | Tamil | |
| TE | Telugu | |
| TH | Thai | |
| UR | Urdu | |
| VI | Vietnamese | |
| SQ | Albanian |
🔧 Translate to Multiple Languages
Endpoint
POST https://api.scriptix.io/api/v3/speech-to-text/session/{sessionId}/document/{document_id}/translate-multiple
Request Body
{
"languages": ["FR", "DE", "ES"],
"filename": "multilang-meeting-notes",
"webhook_url": "https://your-domain.com/scriptix-callback",
"webhook_method": "POST",
"webhook_headers": [
"Authorization: YOUR_TOKEN"
],
"copy_webhook_settings": false
}
✅ Response Codes
| Status Code | Description |
|---|---|
201 | Document(s) successfully created |
400 | Bad request – check the JSON payload and required fields |
401 | Unauthorized – missing or invalid API key |
403 | Forbidden – you do not have access to this resource |
404 | Not found – the session or document could not be found for this token |
500 | Internal error – contact support if persistent |
🧠 Use Cases
- Translate meeting notes to share with international teams
- Automatically localize transcripts for multilingual reports
- Centralize callback automation with webhook integration