WIwistia
Media

Move Media

Changed on

Moves up to 100 media to a folder and optional subfolder. The subfolder must belong to the specified folder.

This endpoint allows 10 requests per 5 minutes, separate from the general API rate limit. Returns a Background Job because the move is asynchronous.

For more than 100 media, multiple destinations, or mixed actions, use the Create Bulk Actions endpoint with move actions.

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 authorizations granting the update permission on every media being moved and on the destination folder can also be used. subfolder_id is not available to expiring access tokens.

put/medias/move

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/medias/move
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Request body

hashed_idsstring[] required

An array of the media hashed IDs to be moved.

folder_idstring required

The hashed ID of the folder where you want the media moved.

subfolder_idstring

Optional. The hashed ID of the subfolder where you want the media moved. If not provided, media will be moved to the folder's default subfolder. The subfolder must belong to the specified folder.

Response

Successfully queued move of all the media.

messagestring required

A confirmation message that the background job has been queued.

Changes