API Evangelist conversational phrasing for Wistia Media API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Wistia Media API
  version: 1.0.0
extends: openapi/wistia-media-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: 13
- target: $.paths['/medias'].get
  update:
    x-apievangelist-phrasing:
      intent: List my media
      effect: read
      questions:
      - What videos do I have in my account?
      - Can I get a list of all my uploaded media?
      instructions:
      - text: List all media in my account.
      - text: Show me my videos and audio files.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a media item
      effect: read
      questions:
      - How do I look up the details of a single video?
      - What information is stored for one media item?
      instructions:
      - text: Show media {media}.
        slots:
          media: path.mediaHashedId
      - text: Get the details of video {media}.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a media item
      effect: write
      questions:
      - How do I rename a video or edit its description?
      - Can I change a single video's details after upload?
      instructions:
      - text: Update media {media}.
        slots:
          media: path.mediaHashedId
      - text: Edit the name and description of video {media}.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a media item
      effect: destructive
      questions:
      - How do I permanently delete a video?
      - Can I remove a single media file from my account?
      instructions:
      - text: Delete media {media}.
        slots:
          media: path.mediaHashedId
      - text: Permanently remove video {media}.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Duplicate one media item
      effect: write
      questions:
      - How do I make a copy of one video?
      - Can I duplicate a single video into another project?
      instructions:
      - text: Copy media {media}.
        slots:
          media: path.mediaHashedId
      - text: Make a duplicate of video {media}.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/swap'].put
  update:
    x-apievangelist-phrasing:
      intent: Swap a video's source file
      effect: write
      questions:
      - How do I replace a video's file but keep its embed codes and stats?
      - Can I swap in a new version of a video without changing its link?
      instructions:
      - text: Swap the file behind media {media}.
        slots:
          media: path.mediaHashedId
      - text: Replace the content of video {media} while keeping its embeds.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Show a video's aggregated stats
      effect: read
      questions:
      - How many plays and visitors has one of my videos had overall?
      - What's the overall engagement for a single embedded video?
      instructions:
      - text: Show aggregated stats for media {media}.
        slots:
          media: path.mediaHashedId
      - text: Get the play count and engagement totals for video {media}.
        slots:
          media: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/translate'].post
  update:
    x-apievangelist-phrasing:
      intent: Translate a video's transcript
      effect: write
      questions:
      - Can I translate a video's transcript into another language?
      - Is it possible to specify the source language when translating a transcript?
      instructions:
      - text: Translate the transcript of video {media} into {target_language}.
        slots:
          media: path.mediaHashedId
          target_language: requestBody.target_language
      - text: Translate media {media} from {source_language} to {target_language}.
        slots:
          media: path.mediaHashedId
          source_language: requestBody.source_language
          target_language: requestBody.target_language
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/import_url'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a video from a URL
      effect: write
      questions:
      - Can I add a video to my account from a public URL instead of uploading it?
      - Does importing media from a URL happen right away or as a background job?
      instructions:
      - text: Import the video at {url}.
        slots:
          url: requestBody.url
      - text: Import media from {url} into folder {folder}.
        slots:
          url: requestBody.url
          folder: requestBody.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/archive'].put
  update:
    x-apievangelist-phrasing:
      intent: Archive media
      effect: write
      questions:
      - How do I archive videos I don't need right now without deleting them?
      - Can I put several media items into the archive?
      instructions:
      - text: Archive media {hashed_ids}.
        slots:
          hashed_ids: requestBody.hashed_ids
      - text: Send videos {hashed_ids} to the archive, up to 100 at a time.
        slots:
          hashed_ids: requestBody.hashed_ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Move several media items
      effect: write
      questions:
      - How do I move a batch of videos into a different project?
      - Can I relocate many media files at once?
      instructions:
      - text: Move media {hashed_ids} into folder {folder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
      - text: Relocate videos {hashed_ids} to folder {folder} and subfolder {subfolder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
          subfolder: requestBody.subfolder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/restore'].put
  update:
    x-apievangelist-phrasing:
      intent: Restore archived media
      effect: write
      questions:
      - How do I bring back videos I archived?
      - Can I unarchive media so it's active again?
      instructions:
      - text: Restore archived media {hashed_ids} into folder {folder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
      - text: Unarchive videos {hashed_ids} back to folder {folder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy many media items at once
      effect: write
      questions:
      - How do I duplicate a whole batch of videos in one go?
      - Can I copy multiple media files in a single request?
      instructions:
      - text: Bulk copy media {hashed_ids} into folder {folder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
      - text: Duplicate several videos {hashed_ids} at once into folder {folder}.
        slots:
          hashed_ids: requestBody.hashed_ids
          folder: requestBody.folder_id
      method: generated
      generated: '2026-10-01'