API Evangelist conversational phrasing for App Store Connect App Store Version Localizations API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect App Store Version Localizations API
  version: 1.0.0
extends: openapi/ios-appstoreversionlocalizations-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: 12
- target: $.paths['/v1/appStoreVersionLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to an App Store version
      effect: write
      questions:
      - How do I add a Japanese description and keywords to my upcoming App Store version?
      - Can I create a new locale for a version's store listing before submitting it?
      instructions:
      - text: Create an App Store version localization with {data}.
        slots:
          data: requestBody.data
      - text: Add a new language to my version's store listing using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an App Store version localization
      effect: read
      questions:
      - What description, promotional text and what's-new notes does one version localization hold?
      - Can I read the marketing and support URLs of a single localized listing?
      instructions:
      - text: Show App Store version localization {id}.
        slots:
          id: path.id
      - text: Fetch the localized store text of version localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an App Store version localization
      effect: destructive
      questions:
      - Can I remove a language from my version's App Store listing?
      - What happens to screenshots when I delete a version localization?
      instructions:
      - text: Delete App Store version localization {id}.
        slots:
          id: path.id
      - text: Remove locale {id} from the version's store listing.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a version's localized store text
      effect: write
      questions:
      - Can I change the what's-new text for one language after I already created it?
      - Is promotional text editable on an existing version localization?
      instructions:
      - text: Update App Store version localization {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Rewrite the description and release notes on localization {id} to {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/relationships/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List app preview set IDs for a version localization
      effect: read
      questions:
      - Which app preview set IDs belong to a version localization?
      - Can I get only the preview set references for a locale without the video details?
      instructions:
      - text: List only the app preview set IDs for localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} preview set linkages for version localization {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List app preview video sets for a version localization
      effect: read
      questions:
      - What app preview video sets exist for this language of my listing?
      - Can I filter a localization's preview sets by device type, like iPhone 6.7-inch?
      instructions:
      - text: Show the app preview sets for version localization {id}.
        slots:
          id: path.id
      - text: List the {previewType} preview sets of localization {id}.
        slots:
          id: path.id
          previewType: query.filter[previewType]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/relationships/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot set IDs for a version localization
      effect: read
      questions:
      - Which screenshot set IDs are attached to a version localization?
      - Can I get only the screenshot set references for a locale?
      instructions:
      - text: List only the screenshot set IDs for localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} screenshot set linkages for version localization {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot sets for a version localization
      effect: read
      questions:
      - Which device sizes have screenshots uploaded for this language of my version?
      - Can I pull just the iPad Pro screenshot set for a localization?
      instructions:
      - text: Show the screenshot sets for version localization {id}.
        slots:
          id: path.id
      - text: Get the {screenshotDisplayType} screenshot set for localization {id}.
        slots:
          id: path.id
          screenshotDisplayType: query.filter[screenshotDisplayType]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/relationships/searchKeywords'].get
  update:
    x-apievangelist-phrasing:
      intent: List search keyword IDs for a version localization
      effect: read
      questions:
      - Which search keyword IDs are linked to a version localization?
      - Can I page through just the keyword references for a locale?
      instructions:
      - text: List only the search keyword IDs on localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} keyword linkages for version localization {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/relationships/searchKeywords'].post
  update:
    x-apievangelist-phrasing:
      intent: Add search keywords to a version localization
      effect: write
      questions:
      - How can I attach more search keywords to one language of my App Store listing?
      - Can I link existing keyword records to a localization in bulk?
      instructions:
      - text: Add search keywords {data} to localization {id}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Link keywords {data} to version localization {id}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/relationships/searchKeywords'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove search keywords from a version localization
      effect: destructive
      questions:
      - Can I detach keywords that no longer fit from one language of my listing?
      - Is there a way to unlink several search keywords from a localization at once?
      instructions:
      - text: Remove search keywords {data} from localization {id}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Unlink keywords {data} from version localization {id}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionLocalizations/{id}/searchKeywords'].get
  update:
    x-apievangelist-phrasing:
      intent: List search keywords for a version localization
      effect: read
      questions:
      - What search keywords is this localized listing using right now?
      - Can I filter a localization's keywords by platform or locale?
      instructions:
      - text: Show the full search keywords for version localization {id}.
        slots:
          id: path.id
      - text: List the {platform} keywords on localization {id} for locale {locale}.
        slots:
          id: path.id
          platform: query.filter[platform]
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'