# 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 Build Bundles API
  version: 1.0.0
extends: openapi/ios-buildbundles-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: 8
- target: $.paths['/v1/buildBundles/{id}/relationships/appClipDomainCacheStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Clip domain cache status ID
      effect: read
      questions:
      - Which App Clip domain cache status record ID belongs to a build bundle?
      - Can I get only the cache status linkage for a build bundle?
      instructions:
      - text: Return only the App Clip domain cache status ID for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Look up the cache status relationship of bundle {bundle}.
        slots:
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/appClipDomainCacheStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check App Clip domain cache status
      effect: read
      questions:
      - Has Apple's CDN cached the associated domains for my App Clip yet?
      - What domain validation results did the production cache record for a build bundle?
      instructions:
      - text: Show the App Clip domain cache status details for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Check whether associated domains for bundle {bundle} are cached and valid.
        slots:
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/relationships/appClipDomainDebugStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Clip domain debug status ID
      effect: read
      questions:
      - Which App Clip domain debug status record ID is on a build bundle?
      - Can I get just the debug status linkage for a build bundle?
      instructions:
      - text: Return only the App Clip domain debug status ID for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Look up the debug status relationship of bundle {bundle}.
        slots:
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/appClipDomainDebugStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check App Clip domain debug status
      effect: read
      questions:
      - Why is my App Clip's associated domain failing in developer mode testing?
      - What do the debug-mode domain checks report for a build bundle?
      instructions:
      - text: Show the App Clip domain debug status details for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Diagnose associated domain errors in debug mode for bundle {bundle}.
        slots:
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/relationships/betaAppClipInvocations'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta App Clip invocation IDs
      effect: read
      questions:
      - Which TestFlight App Clip invocation IDs are set on a build bundle?
      - Can I get only the identifiers of a bundle's beta invocations?
      instructions:
      - text: List only the beta App Clip invocation IDs for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Return up to {limit} beta invocation identifiers for bundle {bundle}.
        slots:
          limit: query.limit
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/betaAppClipInvocations'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta App Clip invocations for testers
      effect: read
      questions:
      - What invocation URLs can TestFlight testers use to launch my App Clip?
      - Can I see each beta App Clip invocation with its localized titles?
      instructions:
      - text: Show the full beta App Clip invocations for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: List tester invocation URLs for bundle {bundle} and include {include}.
        slots:
          bundle: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/relationships/buildBundleFileSizes'].get
  update:
    x-apievangelist-phrasing:
      intent: List file size record IDs for a build bundle
      effect: read
      questions:
      - Which file size record IDs are attached to a build bundle?
      - Can I fetch only the identifiers of a bundle's size entries?
      instructions:
      - text: List only the file size record IDs for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Return up to {limit} size entry identifiers for bundle {bundle}.
        slots:
          limit: query.limit
          bundle: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildBundles/{id}/buildBundleFileSizes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get download and install sizes per device
      effect: read
      questions:
      - How big is my app to download and install on each device model?
      - What are the per-device download and install sizes for a build bundle?
      instructions:
      - text: Show download and install sizes by device for build bundle {bundle}.
        slots:
          bundle: path.id
      - text: Get up to {limit} per-device file sizes for bundle {bundle}.
        slots:
          limit: query.limit
          bundle: path.id
      method: generated
      generated: '2026-10-01'