Upload Transcription File
This endpoint uploads subtitle files for hearing impaired viewers. Both SRT and WebVTT uploads are supported formats.
Path Parameters
| Parameter | Type | Validations |
|---|---|---|
| videoId | string, required | ID of the video to upload and attach subtitle file to |
Request Body
{
"files": [
{
"fileName": "string",
"language": "string"
}
]
}
| Parameter | Type | Validations |
|---|---|---|
| file | multipart/form-data, required | The transcription file to upload and associate to the video. Must be a SRT or VTT file type. You must also provide the Content-Type header for the uploaded file. |
| TranscriptionFiles[ ] | files[{fileName, language}], string, optional | Data object of transcription file details attached to the video. Multiple files can be assigned. Includes fileName and language string(s) using a supported language code. |
REQUEST: Upload Transcription File
--------FormBoundary
Content-Disposition: form-data; name="TranscriptionFiles"
{“files”:[{“fileName”:”english.srt”, “language”: “en”}, {“fileName”:”german.srt”, “language”:”de”}]}
——–FormBoundary
Content-Disposition: form-data; name=”File1″; filename=”english.srt”
Content-Type: application/octet-stream
���ftypmp42����isommp42��:moov���lmvhd�������[���[��[1]X��/��������������������������������������������@������������������������������
���iods�����O��)���
——–FormBoundary
Content-Disposition: form-data; name=”File2″; filename=”german.srt”
Content-Type: application/octet-stream
���ftypmp42����isommp42��:moov���lmvhd�������[���[��[1]X��/��������������������������������������������@������������������������������
���iods�����O��)���
——–FormBoundary
Response Body
successful response
Unauthorized error
Internal server error
Errors may include:
- MalformedRequest = “Bad request format. Please check your request.”;
- FileNotSupported = “Sorry! Cannot upload this file type.”;
- FileNotSent = “The video file was not uploaded.”;
- UserNotProvided = “Unable to upload video. Please ensure that video is associated to a valid user.”;
- UserDoesNotExist = “Unable to upload video. Please ensure that video is associated to a valid user.”;
- InternalServerError = “Unable to process request at this time. Please try again later.”