# 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 Review Submissions API
  version: 1.0.0
extends: openapi/ios-betaappreviewsubmissions-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: 5
- target: $.paths['/v1/betaAppReviewSubmissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta app review submissions for a build
      effect: read
      questions:
      - Has my build been submitted for TestFlight beta review?
      - Can I filter beta review submissions by review state like approved or rejected?
      instructions:
      - text: List beta review submissions for build {build}.
        slots:
          build: query.filter[build]
      - text: Show submissions for build {build} in state {state}.
        slots:
          build: query.filter[build]
          state: query.filter[betaReviewState]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewSubmissions'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a build for beta app review
      effect: write
      questions:
      - How do I send a build to Apple for TestFlight external beta review?
      - Can I submit a build for beta review through the API?
      instructions:
      - text: Submit a build for beta app review with {details}.
        slots:
          details: requestBody.data
      - text: 'Send this build to TestFlight beta review: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewSubmissions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta app review submission
      effect: read
      questions:
      - What's the review state of a specific beta review submission?
      - When was a TestFlight beta review submission made?
      instructions:
      - text: Show beta review submission {id}.
        slots:
          id: path.id
      - text: Get the status of beta review submission {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewSubmissions/{id}/relationships/build'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build ID of a beta review submission
      effect: read
      questions:
      - Can I get just the build ID for a beta review submission?
      - Which build identifier was submitted for this review?
      instructions:
      - text: Get only the build ID for beta review submission {id}.
        slots:
          id: path.id
      - text: Return the build linkage of submission {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewSubmissions/{id}/build'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build in a beta review submission
      effect: read
      questions:
      - Which build version was sent to beta review in a submission?
      - Can I get the full build record behind a review submission?
      instructions:
      - text: Show the full build for beta review submission {id}.
        slots:
          id: path.id
      - text: Which build was submitted in review submission {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'