Skip to main content
POST
/
video
/
v1
/
videos
/
{videoId}
/
captions
Upload a caption track
curl --request POST \
  --url https://api.voyant.travel/video/v1/videos/{videoId}/captions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "language": "en",
  "vtt": "<string>",
  "label": "<string>"
}
'
{
  "data": {
    "id": "<string>",
    "videoId": "<string>",
    "organizationId": "<string>",
    "language": "<string>",
    "generated": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "label": "<string>",
    "errorMessage": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Voyant Cloud API token, passed as Authorization: Bearer <token>. Each token carries a fixed set of scopes; an operation rejects tokens missing its required scope.

Path Parameters

​
videoId
string
required

Body

application/json
​
language
string
required

BCP-47 language tag (e.g. en, pt-BR).

Example:

"en"

​
vtt
string
required

WebVTT caption content.

Required string length: 1 - 2000000
​
label
string | null
Maximum string length: 120

Response

Caption uploaded

​
data
object
required