WIwistia
Captions

Update Captions

Changed on

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.

put/medias/{mediaHashedId}/captions/{languageCode}

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/medias/{mediaHashedId}/captions/{languageCode}
  • Auth
    HTTP bearer

Path parameters

mediaHashedIdstring required

Unique identifier for the media.

languageCodestring required

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

Headers

X-Wistia-API-Versionstring required

Request body

caption_filestring required

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

Response

Successful operation. Captions replaced.

Changes