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.

​
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. (This can only be one of all,af,al,ar,ar-EG,ar-lb,az,bg,bn,da,de,el,en,es,es-mx,et,fa,fi,fr,fr-ca,ha,he,hi,hr,hu,id,it,ja,khm,kg,kk,ko,lt,lv,md,mk,ms,nl,no,pl,pt,pt-pt,ro,ru,sg-ma,sg-ms,sk,sl,sr,sv,sw,ta,te,th,tj,tl,tr,uk,ur,ur-lt,uz,vi,xh,yo,zh,zh-tw,zu)

​
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"
}