WIwistia
Customizations

Update Thumbnail Customizations

Changed on

Applies a partial update to a video's thumbnail customizations. Only the fields supplied are changed; sending a field as null deletes it (reverting to the default).

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 permission on this media can also be used.

put/medias/{mediaId}/customizations/thumbnail

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/medias/{mediaId}/customizations/thumbnail
  • Auth
    HTTP bearer

Path parameters

mediaIdstring required

The hashed ID of the video to be customized.

Headers

X-Wistia-API-Versionstring required

Request body

stillUrlstring

Overrides the thumbnail image that appears before the video plays.

thumbnailAltTextstring

Alt text for the thumbnail image, used for accessibility.

fitStrategystring

Resizes the thumbnail when there's a discrepancy between its aspect ratio and that of its parent container. Options are contain, cover, fill, and none.

unalteredStillImageAssetstring

Reference to the original, unaltered still image asset.

Response

Thumbnail customization update successful

stillUrlstring
thumbnailAltTextstring
fitStrategystring

Changes