# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Wistia Folders API
  version: 1.0.0
extends: openapi/wistia-folders-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: 6
- target: $.paths['/folders'].get
  update:
    x-apievangelist-phrasing:
      intent: List folders
      effect: read
      questions:
      - What folders do I have in my Wistia account?
      - Are My Library folders included when listing folders?
      instructions:
      - text: List my folders.
      - text: Show my folders sorted by {sort_by}.
        slots:
          sort_by: query.sort_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a folder
      effect: write
      questions:
      - How do I make a new folder for my videos?
      - Can I create a public folder with a specific admin?
      instructions:
      - text: Create a folder named {name}.
        slots:
          name: requestBody.name
      - text: Create folder {name} with {adminEmail} as admin.
        slots:
          name: requestBody.name
          adminEmail: requestBody.adminEmail
      method: generated
      generated: '2026-10-01'
- target: $.paths['/folders/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Show a folder
      effect: read
      questions:
      - How do I get the details of one folder?
      - Where can I see a single folder's settings?
      instructions:
      - text: Show folder {id}.
        slots:
          id: path.id
      - text: Get the details of folder {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/folders/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a folder
      effect: write
      questions:
      - How do I rename a folder or change its description?
      - Can I allow anonymous uploads or downloads on a folder?
      instructions:
      - text: Rename folder {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Set anonymous downloads on folder {id} to {anonymousCanDownload}.
        slots:
          id: path.id
          anonymousCanDownload: requestBody.anonymousCanDownload
      method: generated
      generated: '2026-10-01'
- target: $.paths['/folders/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a folder
      effect: destructive
      questions:
      - How do I delete a folder I no longer need?
      - Can I remove an entire folder from my account?
      instructions:
      - text: Delete folder {id}.
        slots:
          id: path.id
      - text: Remove folder {id} from my account.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/folders/{id}/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a folder with its media
      effect: write
      questions:
      - How do I duplicate a folder along with all its media and subfolders?
      - Does copying a folder carry over who it was shared with?
      instructions:
      - text: Copy folder {id}.
        slots:
          id: path.id
      - text: Duplicate folder {id} and make {adminEmail} the admin of the copy.
        slots:
          id: path.id
          adminEmail: requestBody.adminEmail
      method: generated
      generated: '2026-10-01'