Update Captions

This method is for replacing the captions on a video or audio media for the specified language.

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 edit-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

Unique identifier for the media.

string
required
^[a-z]{3}$

Language code conforming to ISO-639-2 for which the captions should be updated.

Body Params
string
required

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

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

Generated from available request content types

Allowed:
Responses
200

Successful operation. Captions replaced.

404

Captions or 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