Wistia · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Wistia Localizations API

5 actions 5 updates phrasing extends openapi/wistia-localizations-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 5

$.info
$.paths['/medias/{mediaHashedId}/localizations'].get
$.paths['/medias/{mediaHashedId}/localizations'].post
$.paths['/medias/{mediaHashedId}/localizations/{localizationHashedId}'].get
$.paths['/medias/{mediaHashedId}/localizations/{localizationHashedId}'].delete

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