WIwistia
Localizations

Create Localization

Changed on

Creates a new localization.

Creating a localization can incur a charge on your account. Accounts get a free-dub allowance; once it is used up, dubs bill per minute at the account's configured rate.

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 translate permission on this media can also be used. The localization is ordered on behalf of the contact the token was created for. Reading the localization afterwards needs the edit-transcripts permission.

post/medias/{mediaHashedId}/localizations

Request

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

Path parameters

mediaHashedIdstring required

The hashed ID of the media to create a localization for.

Headers

X-Wistia-API-Versionstring required

Request body

output_languagestring required

The language to localize the media to as a 3-character IETF language code.

auto_enableboolean

Whether to automatically enable the localization.

Response

Successful creation of the localization.

hashed_idstring required

A unique alphanumeric identifier for this localization.

language_codestring required

A 3-character language code as specified by IETF.

iso639_2_language_codestring required

A 2-character language code as specified by ISO-639–2.

language_namestring required

The name of the language in English.

native_language_namestring required

The name of the language in the language of the localization.

created_atstring date-time required

The date when the localization was created.

updated_atstring date-time required

The date when the localization was last updated.

ordered_atstring date-time nullable required

The date when the localization was ordered.

enabled_atstring date-time nullable required

The date when the localization was enabled.

enabledboolean required

Whether or not the localization is enabled.

auto_enable_dubbingboolean required

Whether or not the dubbing will be automatically enabled when completed.

expected_billed_minutesnumber nullable required

The expected number of minutes that will be billed for the dubbing.

expected_billed_creditsstring nullable required

The credits held for the dubbing, deducted when it completes. Null when the dubbing is not paid for with credits. Decimal amounts are returned as strings.

billed_atstring date-time nullable required

The date when the dubbing was billed.

Changes