Wistia · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Wistia Data Medias API

12 actions 12 updates phrasing extends openapi/wistia-medias-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 12

$.info
$.paths['/medias'].get
$.paths['/medias'].post
$.paths['/medias/{hashedId}'].get
$.paths['/medias/{hashedId}'].put
$.paths['/medias/{hashedId}'].delete
$.paths['/medias/{hashedId}/copy'].post
$.paths['/medias/{hashedId}/swap'].put
$.paths['/medias/move'].put
$.paths['/medias/archive'].put
$.paths['/medias/restore'].put
$.paths['/medias/copy'].put

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Wistia Data Medias API
  version: 1.0.0
extends: openapi/wistia-medias-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: 11
- 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'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload or import media
      effect: write
      questions:
      - How do I upload a new video to Wistia?
      - Can I import a video from a URL instead of uploading a file?
      instructions:
      - text: Upload a new video to my account.
      - text: Import a media file into my library from a link.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{hashedId}'].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.hashedId
      - text: Get the details of video {media}.
        slots:
          media: path.hashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{hashedId}'].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.hashedId
      - text: Edit the name and description of video {media}.
        slots:
          media: path.hashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{hashedId}'].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.hashedId
      - text: Permanently remove video {media}.
        slots:
          media: path.hashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{hashedId}/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.hashedId
      - text: Make a duplicate of video {media}.
        slots:
          media: path.hashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{hashedId}/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.hashedId
      - text: Replace the content of video {media} while keeping its embeds.
        slots:
          media: path.hashedId
      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 these media items to another project.
      - text: Move multiple videos in one request.
      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 the selected media.
      - text: Send these videos to the archive.
      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 my archived media.
      - text: Unarchive these videos.
      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 these media items.
      - text: Copy several videos at once.
      method: generated
      generated: '2026-10-01'