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