Create Captions

Adds captions to a specified media by providing an SRT file or its contents directly.

Requires api token with one of the following permissions

Read, update & delete anything

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An expiring access token
created with the all:delegate_to_contact_permissions scope and an
authorization granting the create-transcripts permission on this media can
also be used.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The hashed ID of the media for which captions are to be added.

Body Params
string
required

Either an attached SRT file or a string parameter with the contents of an SRT file.

string

An optional parameter that denotes which language this file represents. Should conform to ISO-639–2. If left unspecified, the language code will be detected automatically.

Headers
string
required
Defaults to 2026-09
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses
200

Captions added successfully

400

Captions already exist for this media

404

Media not found

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json