# 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 Ci Mac Os Versions API
  version: 1.0.0
extends: openapi/ios-cimacosversions-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: 4
- target: $.paths['/v1/ciMacOsVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List macOS versions available in Xcode Cloud
      effect: read
      questions:
      - Which macOS versions can my Xcode Cloud builds run on?
      - What macOS options does Xcode Cloud offer for a workflow?
      instructions:
      - text: List all macOS versions available in Xcode Cloud.
      - text: Show the first {limit} Xcode Cloud macOS versions.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciMacOsVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Xcode Cloud macOS version
      effect: read
      questions:
      - What are the details of one Xcode Cloud macOS version?
      - Can I look up a CI macOS version by its ID?
      instructions:
      - text: Show Xcode Cloud macOS version {id}.
        slots:
          id: path.id
      - text: Fetch the name and version string of CI macOS {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciMacOsVersions/{id}/relationships/xcodeVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Xcode version IDs for a macOS version
      effect: read
      questions:
      - Which Xcode version IDs are supported on a given Xcode Cloud macOS?
      - Can I get only identifiers of the Xcodes paired with a CI macOS version?
      instructions:
      - text: List the Xcode version IDs linked to CI macOS version {id}.
        slots:
          id: path.id
      - text: Return only Xcode references for Xcode Cloud macOS {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciMacOsVersions/{id}/xcodeVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Xcode versions for a macOS version
      effect: read
      questions:
      - What Xcode releases can I use with this Xcode Cloud macOS version?
      - Does a particular Xcode Cloud macOS support the Xcode beta I need?
      instructions:
      - text: Show the full Xcode versions that run on CI macOS version {id}.
        slots:
          id: path.id
      - text: List compatible Xcode releases with their test destinations for macOS {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'