API Evangelist conversational phrasing for App Store Connect Beta Groups 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 Beta Groups API
  version: 1.0.0
extends: openapi/ios-betagroups-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: 21
- target: $.paths['/v1/betaGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List TestFlight beta groups
      effect: read
      questions:
      - Which TestFlight beta groups do I have across my apps?
      - Can I filter beta groups to only the internal ones or those with a public link enabled?
      - How do I find a beta group by its name in App Store Connect?
      instructions:
      - text: List all my TestFlight beta groups.
      - text: Find the beta groups named {name}.
        slots:
          name: query.filter[name]
      - text: List the beta groups that belong to app {app}.
        slots:
          app: query.filter[app]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a TestFlight beta group
      effect: write
      questions:
      - How do I set up a new TestFlight tester group for my app?
      - Can I create an external beta group with a public invite link?
      instructions:
      - text: Create a new TestFlight beta group with {details}.
        slots:
          details: requestBody.data
      - text: Set up a beta group for my app using {details}.
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta group's details
      effect: read
      questions:
      - What settings does a specific TestFlight beta group have?
      - Can I see whether one beta group's public link is turned on?
      instructions:
      - text: Show me the details of beta group {id}.
        slots:
          id: path.id
      - text: Get beta group {id} and its settings.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a beta group
      effect: destructive
      questions:
      - How do I remove a TestFlight beta group I no longer use?
      - What happens to testers when I delete a beta group?
      instructions:
      - text: Delete beta group {id}.
        slots:
          id: path.id
      - text: Remove the TestFlight group {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a beta group's settings
      effect: write
      questions:
      - Can I rename a beta group or change its public link limit?
      - How do I turn on the public link for an existing beta group?
      instructions:
      - text: Update beta group {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Change the settings of beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app ID linked to a beta group
      effect: read
      questions:
      - Which app ID is a beta group linked to, without the full app record?
      - Can I get just the app identifier for a TestFlight group?
      instructions:
      - text: Get only the app ID that beta group {id} belongs to.
        slots:
          id: path.id
      - text: Return the app linkage for beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app a beta group belongs to
      effect: read
      questions:
      - What app does this TestFlight beta group test?
      - Can I pull the full app record behind a beta group?
      instructions:
      - text: Show me the full app details for beta group {id}.
        slots:
          id: path.id
      - text: Which app is beta group {id} testing.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/betaRecruitmentCriteria'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the recruitment criteria ID of a beta group
      effect: read
      questions:
      - Does a beta group have recruitment criteria attached, by ID only?
      - Can I get the identifier of a group's tester recruitment criteria?
      instructions:
      - text: Get just the recruitment criteria ID for beta group {id}.
        slots:
          id: path.id
      - text: Return the recruitment criteria linkage of beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/betaRecruitmentCriteria'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta group's tester recruitment criteria
      effect: read
      questions:
      - What device and OS criteria is a beta group using to recruit testers?
      - Can I see the full recruitment criteria for a public TestFlight group?
      instructions:
      - text: Show the tester recruitment criteria for beta group {id}.
        slots:
          id: path.id
      - text: What recruitment filters does beta group {id} apply.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/betaRecruitmentCriterionCompatibleBuildCheck'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the compatible build check ID for a beta group
      effect: read
      questions:
      - Can I get the ID of a group's recruitment compatible-build check?
      - Is there a compatible build check linked to this beta group, by reference only?
      instructions:
      - text: Get only the compatible build check ID for beta group {id}.
        slots:
          id: path.id
      - text: Return the build-check linkage of beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/betaRecruitmentCriterionCompatibleBuildCheck'].get
  update:
    x-apievangelist-phrasing:
      intent: Check build compatibility with recruitment criteria
      effect: read
      questions:
      - Does my beta group have a build that matches its recruitment criteria?
      - Can I see whether recruited testers will have a compatible build to install?
      instructions:
      - text: Check whether beta group {id} has a build compatible with its recruitment criteria.
        slots:
          id: path.id
      - text: Show the compatible build check result for beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/betaTesters'].get
  update:
    x-apievangelist-phrasing:
      intent: List tester IDs in a beta group
      effect: read
      questions:
      - Can I get just the tester IDs that belong to a beta group?
      - How many tester identifiers are linked to one TestFlight group?
      instructions:
      - text: List only the tester IDs in beta group {id}.
        slots:
          id: path.id
      - text: Return up to {limit} tester linkages for beta group {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/betaTesters'].post
  update:
    x-apievangelist-phrasing:
      intent: Add testers to a beta group
      effect: write
      questions:
      - How do I add existing testers to a TestFlight beta group?
      - Can I put several testers into one group in a single call?
      instructions:
      - text: Add testers {testers} to beta group {id}.
        slots:
          testers: requestBody.data
          id: path.id
      - text: 'Put these testers into beta group {id}: {testers}.'
        slots:
          id: path.id
          testers: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/betaTesters'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove testers from a beta group
      effect: destructive
      questions:
      - How do I take testers out of a TestFlight group without deleting them?
      - Can I remove several testers from one beta group at once?
      instructions:
      - text: Remove testers {testers} from beta group {id}.
        slots:
          testers: requestBody.data
          id: path.id
      - text: 'Take these testers out of beta group {id}: {testers}.'
        slots:
          id: path.id
          testers: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/betaTesters'].get
  update:
    x-apievangelist-phrasing:
      intent: List testers in a beta group
      effect: read
      questions:
      - Who are the testers in a particular TestFlight beta group?
      - Can I see the names and emails of everyone in a beta group?
      instructions:
      - text: Show the full tester records in beta group {id}.
        slots:
          id: path.id
      - text: List the people testing in beta group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List build IDs assigned to a beta group
      effect: read
      questions:
      - Can I get just the build IDs a beta group has access to?
      - Which build identifiers are linked to this TestFlight group?
      instructions:
      - text: List only the build IDs assigned to beta group {id}.
        slots:
          id: path.id
      - text: Return up to {limit} build linkages for beta group {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Give a beta group access to builds
      effect: write
      questions:
      - How do I make a new build available to a TestFlight group?
      - Can I assign several builds to one beta group?
      instructions:
      - text: Add builds {builds} to beta group {id}.
        slots:
          builds: requestBody.data
          id: path.id
      - text: 'Make these builds testable by beta group {id}: {builds}.'
        slots:
          id: path.id
          builds: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/relationships/builds'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove builds from a beta group
      effect: destructive
      questions:
      - How do I stop a beta group from testing an older build?
      - Can I pull builds away from a TestFlight group?
      instructions:
      - text: Remove builds {builds} from beta group {id}.
        slots:
          builds: requestBody.data
          id: path.id
      - text: 'Take these builds away from beta group {id}: {builds}.'
        slots:
          id: path.id
          builds: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List builds available to a beta group
      effect: read
      questions:
      - Which builds can testers in a given beta group install?
      - What versions and build numbers is a TestFlight group testing?
      instructions:
      - text: Show the full build details for beta group {id}.
        slots:
          id: path.id
      - text: List the builds testers in beta group {id} can install.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/metrics/betaTesterUsages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get tester usage metrics for a beta group
      effect: read
      questions:
      - How actively are testers in a beta group using my build?
      - Can I break down beta tester usage by tester over a time period?
      instructions:
      - text: Get tester usage metrics for beta group {id} over {period}.
        slots:
          id: path.id
          period: query.period
      - text: Show usage for beta group {id} grouped by {groupBy}.
        slots:
          id: path.id
          groupBy: query.groupBy
      - text: Show usage in beta group {id} for tester {tester}.
        slots:
          id: path.id
          tester: query.filter[betaTesters]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaGroups/{id}/metrics/publicLinkUsages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get public link usage metrics for a beta group
      effect: read
      questions:
      - How many people have joined through a beta group's public TestFlight link?
      - Can I see public invite link usage stats for one group?
      instructions:
      - text: Get public link usage metrics for beta group {id}.
        slots:
          id: path.id
      - text: Show how the public link of beta group {id} is being used.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'