WIwistia
Taggings

Bulk Tag Media

Changed on

This method accepts a list of medias to tag. It processes requests asynchronously and will return a background_job_status object rather than the typical Media response object.

The tags will be added to the existing tags on each media file, not replaced.

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.

Expiring access tokens created with authorizations cannot be used; such requests fail with a 403.

post/taggings/bulk_create

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/taggings/bulk_create
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Request body

hashed_idsstring[] required

An array of the media hashed IDs to be tagged.

tag_namesstring[] required

An array of tag names to add to each media.

Response

Successful tagging of media.

messagestring required

A confirmation message that the background job has been queued.

Changes