# 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 Game Center App Versions API
  version: 1.0.0
extends: openapi/ios-gamecenterappversions-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: 9
- target: $.paths['/v1/gameCenterAppVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable Game Center for an app version
      effect: write
      questions:
      - How do I turn on Game Center for a new version of my game?
      - Can I create a Game Center app version tied to an App Store version?
      instructions:
      - text: Create a Game Center app version with {data}.
        slots:
          data: requestBody.data
      - text: Enable Game Center on my upcoming release using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center app version
      effect: read
      questions:
      - Is Game Center enabled on a given Game Center app version record?
      - What does a single Game Center app version look like?
      instructions:
      - text: Show Game Center app version {id}.
        slots:
          id: path.id
      - text: Fetch the enabled flag and details of Game Center app version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center app version
      effect: write
      questions:
      - Can I switch Game Center off for an existing app version?
      - Which settings on a Game Center app version can I change after creating it?
      instructions:
      - text: Update Game Center app version {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Toggle Game Center on version {id} using {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/relationships/appStoreVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Store version ID for a Game Center version
      effect: read
      questions:
      - Which App Store version ID is a Game Center app version linked to?
      - Can I get just the store version reference from a Game Center app version?
      instructions:
      - text: Return only the App Store version ID linked to Game Center app version {id}.
        slots:
          id: path.id
      - text: Check the store version linkage of Game Center app version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/appStoreVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Store version for a Game Center version
      effect: read
      questions:
      - Which App Store release, with its version string and state, does this Game Center app version belong to?
      - Can I load the full store version from a Game Center app version?
      instructions:
      - text: Show the full App Store version behind Game Center app version {id}.
        slots:
          id: path.id
      - text: Fetch the store release details for Game Center app version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/relationships/compatibilityVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List compatible Game Center version IDs
      effect: read
      questions:
      - Which compatibility version IDs are linked to a Game Center app version?
      - Can I get only the references to versions that share Game Center data with this one?
      instructions:
      - text: List only the compatibility version IDs for Game Center app version {id}.
        slots:
          id: path.id
      - text: Return up to {limit} compatibility linkages for Game Center version {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/relationships/compatibilityVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark Game Center versions as compatible
      effect: write
      questions:
      - How do I let players on an older version of my game share leaderboards with the new one?
      - Can I add compatibility between several Game Center app versions at once?
      instructions:
      - text: Add compatibility versions {data} to Game Center app version {id}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Make Game Center version {id} compatible with {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/relationships/compatibilityVersions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove Game Center version compatibility
      effect: destructive
      questions:
      - Can I stop an old game version from sharing Game Center data with the current one?
      - Is there a way to unlink compatibility versions from a Game Center app version?
      instructions:
      - text: Remove compatibility versions {data} from Game Center app version {id}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Break the compatibility between Game Center version {id} and {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAppVersions/{id}/compatibilityVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List compatible Game Center app versions
      effect: read
      questions:
      - Which other versions of my game are compatible with this Game Center app version?
      - Can I list only the compatible versions that have Game Center enabled?
      instructions:
      - text: Show the full compatible versions for Game Center app version {id}.
        slots:
          id: path.id
      - text: List compatible versions of {id} where enabled is {enabled}.
        slots:
          id: path.id
          enabled: query.filter[enabled]
      method: generated
      generated: '2026-10-01'