# 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'