# 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 Beta App Localizations API
  version: 1.0.0
extends: openapi/ios-betaapplocalizations-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: 7
- target: $.paths['/v1/betaAppLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List TestFlight app localizations
      effect: read
      questions:
      - What TestFlight descriptions and feedback emails have I set per language?
      - Can I see the TestFlight test information for one app or one locale?
      instructions:
      - text: List my TestFlight app localizations.
      - text: Show TestFlight localizations for app {app}.
        slots:
          app: query.filter[app]
      - text: Find the {locale} TestFlight localization.
        slots:
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add TestFlight test information in a language
      effect: write
      questions:
      - How do I add a German description for testers in TestFlight?
      - Can I set a different feedback email and privacy URL per tester language?
      instructions:
      - text: Create a TestFlight localization with {localization_details}.
        slots:
          localization_details: requestBody.data
      - text: Add French beta app information for my app.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a TestFlight app localization
      effect: read
      questions:
      - What does a specific TestFlight localization say to testers?
      - Which feedback email and marketing URL are in one beta localization?
      instructions:
      - text: Show TestFlight localization {localization}.
        slots:
          localization: path.id
      - text: Fetch the description and feedback email of beta localization {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a TestFlight app localization
      effect: destructive
      questions:
      - Can I remove a language from my TestFlight test information?
      - How do I delete a beta app localization I no longer need?
      instructions:
      - text: Delete TestFlight localization {localization}.
        slots:
          localization: path.id
      - text: Remove beta app localization {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a TestFlight app localization
      effect: write
      questions:
      - How do I change what testers see in the TestFlight app description?
      - Can I update the feedback email on an existing beta localization?
      instructions:
      - text: Update TestFlight localization {localization} with a new description.
        slots:
          localization: path.id
      - text: Change the feedback email on beta localization {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations/{id}/relationships/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app ID of a TestFlight localization
      effect: read
      questions:
      - Which app ID does a beta app localization belong to?
      - Can I get only the app reference for a TestFlight localization?
      instructions:
      - text: Get only the app ID for beta localization {localization}.
        slots:
          localization: path.id
      - text: Check which app reference TestFlight localization {localization} has.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppLocalizations/{id}/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app behind a TestFlight localization
      effect: read
      questions:
      - What app name and bundle ID does a TestFlight localization belong to?
      - How do I see the full app record for a beta localization?
      instructions:
      - text: Show the app details for TestFlight localization {localization}.
        slots:
          localization: path.id
      - text: Fetch the full app that beta localization {localization} describes.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'