Skip to main content
POST
Upload VTT (WebVTT) subtitle files to associate with your existing video projects for enhanced accessibility and translation workflows.

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
required
The VTT (WebVTT) subtitle file to upload. Only .vtt format is supported. Maximum file size: 1GB; a larger file is rejected with 400. Note: For testing in the API playground, the upload limit is 5MB.
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.
string
required
Name of the file being uploaded. This will be used as the identifier for your uploaded subtitle content.
string
The source language of the content in the uploaded file, as a BCP-47 language tag listed in Supported Languages. The value all is not accepted: it is rejected with 400 (sourceLanguage must be a valid BCP-47 language tag). Omit the field or send it empty if you don’t want to set it.

Response

string
Unique identifier for the project associated with the uploaded VTT file. This confirms the successful association of the subtitle file with the project.