Wistia · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Data Review Bundles API

4 actions 4 updates phrasing extends openapi/wistia-review-bundles-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Wistia's API. It is a proposal applied on top of the contract, not a document Wistia publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info

$.paths['/review_bundles'].get

$.paths['/review_bundles'].post

$.paths['/review_bundles/{reviewBundleHashedId}'].delete

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Data Review Bundles API
  version: 1.0.0
extends: openapi/wistia-review-bundles-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/review_bundles'].get
  update:
    x-apievangelist-phrasing:
      intent: List review bundles
      effect: read
      questions:
      - What review bundles have I shared for feedback?
      - Which review bundles include a particular video?
      instructions:
      - text: List my review bundles.
      - text: Find review bundles that include media {media_hashed_id}.
        slots:
          media_hashed_id: query.media_hashed_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/review_bundles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a review bundle
      effect: write
      questions:
      - How do I share several videos for review under one link?
      - Can reviewers download the media in a review bundle?
      instructions:
      - text: Create a review bundle {name} with media {media_hashed_ids}.
        slots:
          name: requestBody.name
          media_hashed_ids: requestBody.media_hashed_ids
      - text: Bundle {media_hashed_ids} for review as {name} with downloads {allow_downloads}.
        slots:
          media_hashed_ids: requestBody.media_hashed_ids
          name: requestBody.name
          allow_downloads: requestBody.allow_downloads
      method: generated
      generated: '2026-10-01'
- target: $.paths['/review_bundles/{reviewBundleHashedId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a review bundle
      effect: destructive
      questions:
      - How do I take down a review link I shared?
      - Does deleting a review bundle delete the videos in it?
      instructions:
      - text: Delete review bundle {reviewBundleHashedId}.
        slots:
          reviewBundleHashedId: path.reviewBundleHashedId
      - text: Remove the review link for bundle {reviewBundleHashedId}.
        slots:
          reviewBundleHashedId: path.reviewBundleHashedId
      method: generated
      generated: '2026-10-01'