WIwistia
Captions

Create Captions

Changed on

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.

post/medias/{mediaHashedId}/captions

Request

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

Path parameters

mediaHashedIdstring required

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

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.

languagestring

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.

Response

Captions added successfully

Changes