# 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 Testers API
  version: 1.0.0
extends: openapi/ios-beta-testers-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: 16
- target: $.paths['/v1/betaTesters'].get
  update:
    x-apievangelist-phrasing:
      intent: List TestFlight beta testers
      effect: read
      questions:
      - Who are all the TestFlight beta testers on my account?
      - Can I find a beta tester by email address or last name?
      - Which testers were invited by public link rather than by email?
      instructions:
      - text: List all my TestFlight beta testers.
      - text: Find the beta tester with email {email}.
        slots:
          email: query.filter[email]
      - text: List beta testers in beta group {group}.
        slots:
          group: query.filter[betaGroups]
      - text: Show testers who have access to app {app}.
        slots:
          app: query.filter[apps]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters'].post
  update:
    x-apievangelist-phrasing:
      intent: Invite a new TestFlight beta tester
      effect: write
      questions:
      - How do I add a new external tester to TestFlight?
      - Can I create a beta tester and put them straight into a beta group?
      instructions:
      - text: 'Create a TestFlight tester with these details: {tester_details}.'
        slots:
          tester_details: requestBody.data
      - text: Invite a new beta tester by email to my beta group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta tester's details
      effect: read
      questions:
      - What name, email and invite type does a specific beta tester have?
      - How do I check whether a tester accepted their TestFlight invitation?
      instructions:
      - text: Show me beta tester {tester}.
        slots:
          tester: path.id
      - text: Fetch the profile and invite status of tester {tester}.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a beta tester from TestFlight
      effect: destructive
      questions:
      - How do I completely remove someone from TestFlight testing?
      - Can I delete a beta tester so they lose access to every build?
      instructions:
      - text: Delete beta tester {tester}.
        slots:
          tester: path.id
      - text: Remove tester {tester} from TestFlight entirely.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/apps'].get
  update:
    x-apievangelist-phrasing:
      intent: List app IDs a beta tester can test
      effect: read
      questions:
      - Which app IDs is a beta tester linked to?
      - Can I get just the app references for one tester?
      instructions:
      - text: List only the app IDs tester {tester} is linked to.
        slots:
          tester: path.id
      - text: Get up to {limit} app references for tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/apps'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a beta tester's access to apps
      effect: destructive
      questions:
      - How do I stop a tester from testing one of my apps without deleting them?
      - Can I revoke a tester's access to specific apps only?
      instructions:
      - text: Remove tester {tester} from the selected apps.
        slots:
          tester: path.id
      - text: Revoke app access for beta tester {tester}.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/apps'].get
  update:
    x-apievangelist-phrasing:
      intent: List the apps a beta tester can test
      effect: read
      questions:
      - Which of my apps can a particular beta tester try out?
      - What app names and bundle IDs does a tester have TestFlight access to?
      instructions:
      - text: Show the apps beta tester {tester} can test, with details.
        slots:
          tester: path.id
      - text: List the first {limit} apps available to tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/betaGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta group IDs a tester belongs to
      effect: read
      questions:
      - Which beta group IDs is a tester a member of?
      - Can I get only the group references for a beta tester?
      instructions:
      - text: List only the beta group IDs for tester {tester}.
        slots:
          tester: path.id
      - text: Get up to {limit} group references for tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/betaGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a beta tester to beta groups
      effect: write
      questions:
      - How do I put an existing tester into another TestFlight group?
      - Can I add one tester to several beta groups at once?
      instructions:
      - text: Add tester {tester} to the beta groups {groups}.
        slots:
          tester: path.id
          groups: requestBody.data
      - text: Put beta tester {tester} into my internal QA group.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/betaGroups'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a beta tester from beta groups
      effect: destructive
      questions:
      - How do I take a tester out of a TestFlight group?
      - Can I remove a tester from some groups but keep them in others?
      instructions:
      - text: Remove tester {tester} from beta groups {groups}.
        slots:
          tester: path.id
          groups: requestBody.data
      - text: Take beta tester {tester} out of the external group.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/betaGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List the beta groups a tester is in
      effect: read
      questions:
      - Which TestFlight groups is a tester currently part of?
      - What are the names and settings of the groups a tester belongs to?
      instructions:
      - text: Show the beta groups tester {tester} is in, with details.
        slots:
          tester: path.id
      - text: List the first {limit} groups containing tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List build IDs assigned to a beta tester
      effect: read
      questions:
      - Which build IDs has a tester been given individually?
      - Can I get just the build references assigned to a tester?
      instructions:
      - text: List only the build IDs assigned to tester {tester}.
        slots:
          tester: path.id
      - text: Get up to {limit} build references for tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Give a beta tester access to builds
      effect: write
      questions:
      - How do I assign a specific build to an individual tester?
      - Can I share particular builds with one tester outside a group?
      instructions:
      - text: Give tester {tester} access to builds {builds}.
        slots:
          tester: path.id
          builds: requestBody.data
      - text: Assign the latest build to beta tester {tester}.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/relationships/builds'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a beta tester's access to builds
      effect: destructive
      questions:
      - How do I take away a tester's access to an individual build?
      - Can I unassign certain builds from a tester?
      instructions:
      - text: Remove builds {builds} from tester {tester}.
        slots:
          tester: path.id
          builds: requestBody.data
      - text: Revoke individual build access for tester {tester}.
        slots:
          tester: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List the builds a beta tester can install
      effect: read
      questions:
      - Which builds can a particular tester install right now?
      - What version numbers and processing states do a tester's builds have?
      instructions:
      - text: Show the builds tester {tester} can install, with details.
        slots:
          tester: path.id
      - text: List the first {limit} builds available to tester {tester}.
        slots:
          tester: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaTesters/{id}/metrics/betaTesterUsages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta tester's usage metrics
      effect: read
      questions:
      - How active has a beta tester been, with sessions, crashes and feedback?
      - Can I see a tester's usage of one app over a chosen time period?
      instructions:
      - text: Show usage metrics for tester {tester} on app {app}.
        slots:
          tester: path.id
          app: query.filter[apps]
      - text: Get tester {tester}'s activity in app {app} over {period}.
        slots:
          tester: path.id
          app: query.filter[apps]
          period: query.period
      method: generated
      generated: '2026-10-01'