WIwistia
Review Bundles

Create Review Bundle

Changed on

Creates a review bundle from a set of existing media, producing a single link that can be shared for review. The media to include are specified by their hashed IDs and must already belong to the account. The media can come from any folder. Review Bundles are limited to 25 media.

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 share permission on every listed media can also be used. The new review bundle is not covered by the token that created it, so follow-up requests need a token whose authorizations name the returned hashed id.

post/review_bundles

Request

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

Headers

X-Wistia-API-Versionstring required

Request body

media_hashed_idsstring[] required

The hashed ids of the media to include in the bundle. Limited to 25 media.

namestring required

The bundle display name.

allow_downloadsboolean

Whether the videos in the bundle can be downloaded.

Example request

{
  "name": "My Review Bundle Title"
}

Response

Review Bundle created successfully.

hashed_idstring

A unique alphanumeric identifier for this review bundle.

namestring

The bundle display name.

urlstring

The URL of the bundle.

allow_downloadsboolean

Whether the videos in the bundle can be downloaded.

cursorstring nullable

A cursor for stable pagination based on current sort_by order. You can pass this to cursor[before] or cursor[after] as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with cursor[enabled], or cursor[before] or cursor[after].

Example response

{
  "name": "My Review Bundle Title",
  "url": "https://[your-domain].wistia.com/reviews/bundles/1234567890"
}

Changes