# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Data Remix API
  version: 1.0.0
extends: openapi/wistia-remix-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: 5
- target: $.paths['/remixes'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an AI video remix
      effect: write
      questions:
      - How do I use AI to remix my videos into a new edit?
      - Can I combine several media into one remix with written instructions?
      instructions:
      - text: Remix media {media_hashed_ids} following {instructions}.
        slots:
          media_hashed_ids: requestBody.media_hashed_ids
          instructions: requestBody.instructions
      - text: Start a remix of {media_hashed_ids} with instructions {instructions} saved to folder {folder_id}.
        slots:
          media_hashed_ids: requestBody.media_hashed_ids
          instructions: requestBody.instructions
          folder_id: requestBody.folder_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/remixes/{remixHashedId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a remix job's status
      effect: read
      questions:
      - Is my remix ready to preview yet?
      - When do preview URLs show up for a remix?
      instructions:
      - text: Check the status of remix {remixHashedId}.
        slots:
          remixHashedId: path.remixHashedId
      - text: Get the preview URLs for remix {remixHashedId}.
        slots:
          remixHashedId: path.remixHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/remixes/{remixHashedId}/continue'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a follow-up edit to a remix
      effect: write
      questions:
      - How do I ask for changes to a remix I already made?
      - Does a follow-up edit keep the earlier remix version?
      instructions:
      - text: Continue remix {remixHashedId} with the edit {instructions}.
        slots:
          remixHashedId: path.remixHashedId
          instructions: requestBody.instructions
      - text: 'Revise remix {remixHashedId}: {instructions}.'
        slots:
          remixHashedId: path.remixHashedId
          instructions: requestBody.instructions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/remixes/{remixHashedId}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a finished remix to a folder
      effect: write
      questions:
      - How do I render a finished remix into a real video in my account?
      - What status must a remix reach before I can export it?
      instructions:
      - text: Export remix {remixHashedId} to folder {folder_id}.
        slots:
          remixHashedId: path.remixHashedId
          folder_id: requestBody.folder_id
      - text: Render remix {remixHashedId} as a video named {name}.
        slots:
          remixHashedId: path.remixHashedId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/remix_account_status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check remix credit usage and limits
      effect: read
      questions:
      - How many remix credits have I used this period?
      - What is my account's remix limit?
      instructions:
      - text: Show my remix credit usage and limits.
      - text: Check how many remixes my account has left.
      method: generated
      generated: '2026-10-01'