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