Upload captions or subtitles

PUT

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/stream/{video_identifier}/captions/{language}

Last modified:2022-12-16 13:48:37

Uploads the caption or subtitle file to the endpoint for a specific BCP47 language. One caption or subtitle file per language is allowed.

Request

Path Params

language

string

required

video_identifier

string

required

account_identifier

string

required

Body Params multipart/form-data

file

string

required

The WebVTT file containing the caption or subtitle content.

Example:

@/Users/kyle/Desktop/tr.vtt

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.cloudflare.com/client/v4/accounts//stream//captions/' \
--form 'file="@/Users/kyle/Desktop/tr.vtt"'

Responses

🟢200Upload captions or subtitles response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {},
    "success": true
}

🟢200Upload captions or subtitles response failure

Modified at 2022-12-16 13:48:37

Delete captions or subtitles

Clip videos given a start and end time