# 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 Challenges API
  version: 1.0.0
extends: openapi/ios-gamecenterchallenges-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/gameCenterChallenges'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Game Center challenge
      effect: write
      questions:
      - How do I add a challenge players can send to friends in my game?
      - Can I create a challenge and its related records in one request?
      instructions:
      - text: Create a Game Center challenge with {details}.
        slots:
          details: requestBody.data
      - text: Create a challenge from {details} including {included}.
        slots:
          details: requestBody.data
          included: requestBody.included
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center challenge
      effect: read
      questions:
      - What are the settings of one of my Game Center challenges?
      - Can I see which leaderboard a challenge is built on?
      instructions:
      - text: Show Game Center challenge {id}.
        slots:
          id: path.id
      - text: Get the details of challenge {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center challenge
      effect: destructive
      questions:
      - How do I remove a challenge from my game?
      - Is deleting a Game Center challenge reversible?
      instructions:
      - text: Delete challenge {id}.
        slots:
          id: path.id
      - text: Remove Game Center challenge {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center challenge
      effect: write
      questions:
      - Can I rename a challenge or change whether it's repeatable?
      - How do I edit an existing challenge's attributes?
      instructions:
      - text: Update challenge {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Edit Game Center challenge {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}/relationships/leaderboard'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a challenge to a v1 leaderboard
      effect: write
      questions:
      - How do I point a challenge at a v1 leaderboard?
      - Can I change which original leaderboard backs a challenge?
      instructions:
      - text: Link challenge {id} to v1 leaderboard {leaderboard}.
        slots:
          id: path.id
          leaderboard: requestBody.data
      - text: Set the v1 leaderboard of challenge {id} to {leaderboard}.
        slots:
          id: path.id
          leaderboard: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}/relationships/leaderboardV2'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a challenge to a v2 leaderboard
      effect: write
      questions:
      - How do I attach a challenge to a leaderboard created with the v2 API?
      - Can a challenge use a v2 leaderboard instead of a v1 one?
      instructions:
      - text: Link challenge {id} to v2 leaderboard {leaderboard}.
        slots:
          id: path.id
          leaderboard: requestBody.data
      - text: Set the v2 leaderboard of challenge {id} to {leaderboard}.
        slots:
          id: path.id
          leaderboard: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}/relationships/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List version IDs of a challenge
      effect: read
      questions:
      - Can I get just the version IDs for a Game Center challenge?
      - Which version identifiers belong to a challenge?
      instructions:
      - text: List only the version IDs of challenge {id}.
        slots:
          id: path.id
      - text: Return up to {limit} version linkages for challenge {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterChallenges/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a challenge
      effect: read
      questions:
      - What versions of a challenge exist and what state are they in?
      - Can I see the full version records for a challenge?
      instructions:
      - text: Show all versions of challenge {id}.
        slots:
          id: path.id
      - text: List the full version details for challenge {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'