WIwistia
Media

Swap Media

Changed on

Swap one media with another media. This operation queues a background job to replace the original media with the replacement media while preserving the original media's hashed ID and URLs.

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 can also be used when its authorizations grant the update permission on both the media being replaced and the replacement media. A replacement media the token does not name is treated as not found.

put/medias/{mediaHashedId}/swap

Request

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

Path parameters

mediaHashedIdstring required

Hashed ID of the media to be replaced.

The hashed ID of the media to be replaced.

Headers

X-Wistia-API-Versionstring required

Request body

replacement_media_idstring required

The hashed ID of the media that will replace the original media. Must be the same media type as the original.

Response

Successfully queued background job for media swap.

messagestring required

A confirmation message that the background job has been queued.

Changes