# 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 Build Localizations API
  version: 1.0.0
extends: openapi/ios-betabuildlocalizations-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/betaBuildLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta build localizations
      effect: read
      questions:
      - What localized 'What to Test' notes exist for my TestFlight builds?
      - Can I filter beta build localizations by locale or build?
      instructions:
      - text: List all beta build localizations.
      - text: List beta build localizations for build {build}.
        slots:
          build: query.filter[build]
      - text: Show beta build notes in locale {locale}.
        slots:
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add localized test notes to a build
      effect: write
      questions:
      - How do I add 'What to Test' notes in another language for a TestFlight build?
      - Can I create localized tester instructions for a build?
      instructions:
      - text: Create a beta build localization with {details}.
        slots:
          details: requestBody.data
      - text: 'Add localized What to Test notes: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta build localization
      effect: read
      questions:
      - What do one localization's TestFlight test notes say?
      - Can I read a single beta build localization by ID?
      instructions:
      - text: Show beta build localization {id}.
        slots:
          id: path.id
      - text: Get the What to Test text for localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a beta build localization
      effect: destructive
      questions:
      - How do I remove one language's test notes from a build?
      - Can I delete a beta build localization?
      instructions:
      - text: Delete beta build localization {id}.
        slots:
          id: path.id
      - text: Remove localized test notes {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update localized test notes for a build
      effect: write
      questions:
      - Can I edit the What to Test text after uploading a build?
      - How do I change a beta build localization?
      instructions:
      - text: Update beta build localization {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Change the What to Test notes in localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations/{id}/relationships/build'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build ID of a beta build localization
      effect: read
      questions:
      - Can I get just the build ID a beta localization belongs to?
      - Which build identifier is linked to these test notes?
      instructions:
      - text: Get only the build ID for beta build localization {id}.
        slots:
          id: path.id
      - text: Return the build linkage of localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaBuildLocalizations/{id}/build'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build for a beta build localization
      effect: read
      questions:
      - Which build do these localized test notes describe?
      - Can I get the full build record from a beta build localization?
      instructions:
      - text: Show the full build for beta build localization {id}.
        slots:
          id: path.id
      - text: Which build do the test notes in localization {id} belong to.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'