Skip to main content
POST
/
integration
/
upload
/
vtt
curl -X POST "https://api-integration.ollang.com/integration/upload/vtt" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/subtitles.vtt" \
  -F "projectId=60b8d6f1e1b9b1d8c6c0d8e1" \
  -F "name=batman_returns"

{
  "projectId": "60b8d6f1e1b9b1d8c6c0d8e1"
}
Upload VTT (WebVTT) subtitle files to associate with your existing video projects for enhanced accessibility and translation workflows. 
curl -X POST "https://api-integration.ollang.com/integration/upload/vtt" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/subtitles.vtt" \
  -F "projectId=60b8d6f1e1b9b1d8c6c0d8e1" \
  -F "name=batman_returns"

​
Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here
You can obtain your API key from your Ollang dashboard.

​
Body Parameters

​
file
file
required
The VTT (WebVTT) subtitle file to upload. Only .vtt format is supported. Maximum file size: 1GB. Note: For testing in the API playground, the upload limit is 5MB.
​
projectId
string
required
Unique identifier for the project to associate this VTT file with. This should be an existing project ID from a previous video upload.
​
name
string
required
Name of the file being uploaded. This will be used as the identifier for your uploaded subtitle content.
​
sourceLanguage
string
The source language of the content in the uploaded file. Use one of the codes listed in Supported Languages. The special value all is also accepted for auto-detection workflows.

​
Response

​
projectId
string
Unique identifier for the project associated with the uploaded VTT file. This confirms the successful association of the subtitle file with the project.
{
  "projectId": "60b8d6f1e1b9b1d8c6c0d8e1"
}