# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Wistia Localizations API
  version: 1.0.0
extends: openapi/wistia-localizations-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: 4
- target: $.paths['/medias/{mediaHashedId}/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a media's localizations
      effect: read
      questions:
      - Which languages has this video been localized into?
      - Can I include the transcripts when listing a video's localizations?
      instructions:
      - text: List the localizations for media {mediaHashedId}.
        slots:
          mediaHashedId: path.mediaHashedId
      - text: Show all localizations of video {mediaHashedId} with include_transcript {include_transcript}.
        slots:
          mediaHashedId: path.mediaHashedId
          include_transcript: query.include_transcript
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/localizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Localize a media into another language
      effect: write
      questions:
      - How do I translate a Wistia video into another language?
      - Does creating a localization cost money?
      instructions:
      - text: Localize media {mediaHashedId} into {output_language}.
        slots:
          mediaHashedId: path.mediaHashedId
          output_language: requestBody.output_language
      - text: 'Create a {output_language} localization of video {mediaHashedId} and auto-enable it: {auto_enable}.'
        slots:
          output_language: requestBody.output_language
          mediaHashedId: path.mediaHashedId
          auto_enable: requestBody.auto_enable
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/localizations/{localizationHashedId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Show one localization of a media
      effect: read
      questions:
      - How do I see the details of one specific localization?
      - Can I fetch a single localization with its transcript?
      instructions:
      - text: Show localization {localizationHashedId} of media {mediaHashedId}.
        slots:
          localizationHashedId: path.localizationHashedId
          mediaHashedId: path.mediaHashedId
      - text: Get localization {localizationHashedId} on video {mediaHashedId} including its transcript.
        slots:
          localizationHashedId: path.localizationHashedId
          mediaHashedId: path.mediaHashedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/medias/{mediaHashedId}/localizations/{localizationHashedId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a localization
      effect: destructive
      questions:
      - How do I remove a language localization from a video?
      - Can I delete a translation I no longer want?
      instructions:
      - text: Delete localization {localizationHashedId} from media {mediaHashedId}.
        slots:
          localizationHashedId: path.localizationHashedId
          mediaHashedId: path.mediaHashedId
      - text: Remove the localization {localizationHashedId} on video {mediaHashedId}.
        slots:
          localizationHashedId: path.localizationHashedId
          mediaHashedId: path.mediaHashedId
      method: generated
      generated: '2026-10-01'