# 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 Xcode Versions API
  version: 1.0.0
extends: openapi/ios-cixcodeversions-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/ciXcodeVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Xcode versions available in Xcode Cloud
      effect: read
      questions:
      - Which Xcode versions can my Xcode Cloud workflows build with?
      - Is the latest Xcode release available in Xcode Cloud yet?
      instructions:
      - text: List the Xcode versions available in Xcode Cloud.
      - text: Show the first {limit} Xcode Cloud Xcode versions.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciXcodeVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Xcode Cloud Xcode version
      effect: read
      questions:
      - What test destinations does a specific Xcode version support in Xcode Cloud?
      - Where can I look up one Xcode version's details in Xcode Cloud?
      instructions:
      - text: Show Xcode Cloud Xcode version {xcode}.
        slots:
          xcode: path.id
      - text: Fetch the name and test destinations of Xcode version {xcode}.
        slots:
          xcode: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciXcodeVersions/{id}/relationships/macOsVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List macOS version IDs for an Xcode version
      effect: read
      questions:
      - Which macOS version IDs pair with an Xcode version in Xcode Cloud?
      - Can I get only the macOS references for a given Xcode version?
      instructions:
      - text: List only the macOS version IDs for Xcode version {xcode}.
        slots:
          xcode: path.id
      - text: Get up to {limit} macOS references for Xcode version {xcode}.
        slots:
          xcode: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciXcodeVersions/{id}/macOsVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List macOS versions compatible with an Xcode version
      effect: read
      questions:
      - Which macOS versions can run a particular Xcode version in Xcode Cloud?
      - What macOS options do I have when my workflow uses a specific Xcode?
      instructions:
      - text: Show the macOS versions compatible with Xcode version {xcode}.
        slots:
          xcode: path.id
      - text: List the first {limit} macOS versions that run Xcode version {xcode}.
        slots:
          xcode: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'