# 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 Leaderboards API
  version: 1.0.0
extends: openapi/ios-gamecenterleaderboards-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: 21
- target: $.paths['/v1/gameCenterLeaderboards'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Game Center leaderboard
      effect: write
      questions:
      - How do I add a new leaderboard to my game in Game Center?
      - Can I create a leaderboard with the original v1 endpoint?
      instructions:
      - text: Create a Game Center leaderboard with {details} using the v1 endpoint.
        slots:
          details: requestBody.data
      - text: 'Add a v1 leaderboard to my game: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center leaderboard
      effect: read
      questions:
      - What are the settings of one of my Game Center leaderboards?
      - Can I look up a leaderboard through the v1 API?
      instructions:
      - text: Show v1 leaderboard {id}.
        slots:
          id: path.id
      - text: Get the details of Game Center leaderboard {id} from the v1 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center leaderboard
      effect: destructive
      questions:
      - How do I delete a leaderboard I created with the v1 API?
      - Is deleting a Game Center leaderboard permanent?
      instructions:
      - text: Delete v1 leaderboard {id}.
        slots:
          id: path.id
      - text: Remove Game Center leaderboard {id} via the v1 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center leaderboard
      effect: write
      questions:
      - Can I change a leaderboard's score format or sort order after creating it?
      - Where do I edit a leaderboard using the v1 API?
      instructions:
      - text: Update v1 leaderboard {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Edit the settings of v1 Game Center leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a leaderboard with the v2 API
      effect: write
      questions:
      - How do I create a leaderboard with the newer v2 Game Center endpoint?
      - Can I include related resources when creating a v2 leaderboard?
      instructions:
      - text: Create a v2 Game Center leaderboard with {details}.
        slots:
          details: requestBody.data
      - text: Create a v2 leaderboard from {details} and include {included}.
        slots:
          details: requestBody.data
          included: requestBody.included
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard from the v2 API
      effect: read
      questions:
      - Can I fetch a leaderboard through the v2 Game Center API?
      - What does a v2 leaderboard record contain?
      instructions:
      - text: Show v2 leaderboard {id}.
        slots:
          id: path.id
      - text: Get Game Center leaderboard {id} from the v2 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a v2 leaderboard
      effect: destructive
      questions:
      - How do I delete a leaderboard that was created with the v2 API?
      - Will removing a v2 leaderboard also remove its versions?
      instructions:
      - text: Delete v2 leaderboard {id}.
        slots:
          id: path.id
      - text: Remove Game Center leaderboard {id} using the v2 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a v2 leaderboard
      effect: write
      questions:
      - Can I edit a leaderboard through the v2 Game Center API?
      - How do I change a v2 leaderboard's attributes?
      instructions:
      - text: Update v2 leaderboard {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Edit v2 Game Center leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/activity'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a v1 leaderboard to an activity
      effect: write
      questions:
      - Can I attach a v1 leaderboard to a Game Center activity?
      - How do I change which activity a leaderboard belongs to?
      instructions:
      - text: Link v1 leaderboard {id} to activity {activity}.
        slots:
          id: path.id
          activity: requestBody.data
      - text: Set the Game Center activity of v1 leaderboard {id} to {activity}.
        slots:
          id: path.id
          activity: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/challenge'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a v1 leaderboard to a challenge
      effect: write
      questions:
      - Can I connect a v1 leaderboard to a Game Center challenge?
      - What's the way to set the challenge for a leaderboard?
      instructions:
      - text: Link v1 leaderboard {id} to challenge {challenge}.
        slots:
          id: path.id
          challenge: requestBody.data
      - text: Set the challenge of v1 leaderboard {id} to {challenge}.
        slots:
          id: path.id
          challenge: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/groupLeaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group leaderboard ID of a leaderboard
      effect: read
      questions:
      - Is this leaderboard part of a group leaderboard, by ID only?
      - Can I get just the group leaderboard identifier for a leaderboard?
      instructions:
      - text: Get only the group leaderboard ID for leaderboard {id}.
        slots:
          id: path.id
      - text: Return the group leaderboard linkage of leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/groupLeaderboard'].patch
  update:
    x-apievangelist-phrasing:
      intent: Assign a leaderboard to a group leaderboard
      effect: write
      questions:
      - How do I put a leaderboard into a group leaderboard shared across games?
      - Can I change which group a leaderboard belongs to?
      instructions:
      - text: Assign leaderboard {id} to group leaderboard {group}.
        slots:
          id: path.id
          group: requestBody.data
      - text: Move leaderboard {id} into group {group}.
        slots:
          id: path.id
          group: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/groupLeaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group leaderboard a leaderboard is in
      effect: read
      questions:
      - What group leaderboard does one of my leaderboards roll up to?
      - Can I see the full group leaderboard record for a leaderboard?
      instructions:
      - text: Show the full group leaderboard that leaderboard {id} belongs to.
        slots:
          id: path.id
      - text: Which group leaderboard contains leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of a leaderboard
      effect: read
      questions:
      - Can I get just the localization IDs for a leaderboard?
      - Which localization identifiers are linked to a leaderboard?
      instructions:
      - text: List only the localization IDs of leaderboard {id}.
        slots:
          id: path.id
      - text: Return up to {limit} localization linkages for leaderboard {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a leaderboard's localizations
      effect: read
      questions:
      - What languages is a leaderboard's name and score format translated into?
      - Can I see each localized title and formatter for a leaderboard?
      instructions:
      - text: Show all localizations of leaderboard {id}.
        slots:
          id: path.id
      - text: List the translated names and score formats for leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/relationships/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List release IDs of a leaderboard
      effect: read
      questions:
      - Can I get only the release IDs for a leaderboard?
      - Which release identifiers exist for a Game Center leaderboard?
      instructions:
      - text: List only the release IDs of leaderboard {id}.
        slots:
          id: path.id
      - text: Return up to {limit} release linkages for leaderboard {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboards/{id}/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List a leaderboard's releases
      effect: read
      questions:
      - Is a leaderboard live, and which Game Center releases include it?
      - Can I filter a leaderboard's releases to only the live ones?
      instructions:
      - text: Show the releases of leaderboard {id}.
        slots:
          id: path.id
      - text: List releases of leaderboard {id} where live is {live}.
        slots:
          id: path.id
          live: query.filter[live]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}/relationships/activity'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a v2 leaderboard to an activity
      effect: write
      questions:
      - Can I attach a v2 leaderboard to a Game Center activity?
      - Where do I set the activity for a leaderboard created with v2?
      instructions:
      - text: Link v2 leaderboard {id} to activity {activity}.
        slots:
          id: path.id
          activity: requestBody.data
      - text: Set the activity of v2 leaderboard {id} to {activity}.
        slots:
          id: path.id
          activity: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}/relationships/challenge'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a v2 leaderboard to a challenge
      effect: write
      questions:
      - Can I connect a v2 leaderboard to a Game Center challenge?
      - Which call sets the challenge on a v2 leaderboard?
      instructions:
      - text: Link v2 leaderboard {id} to challenge {challenge}.
        slots:
          id: path.id
          challenge: requestBody.data
      - text: Set the challenge of v2 leaderboard {id} to {challenge}.
        slots:
          id: path.id
          challenge: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}/relationships/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List version IDs of a v2 leaderboard
      effect: read
      questions:
      - Can I get just the version IDs of a v2 leaderboard?
      - Which version identifiers belong to a v2 leaderboard?
      instructions:
      - text: List only the version IDs of v2 leaderboard {id}.
        slots:
          id: path.id
      - text: Return up to {limit} version linkages for v2 leaderboard {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboards/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a v2 leaderboard
      effect: read
      questions:
      - What versions exist for a leaderboard made with the v2 API?
      - Can I see the full version records of a v2 leaderboard?
      instructions:
      - text: Show all versions of v2 leaderboard {id}.
        slots:
          id: path.id
      - text: List the full version details for v2 leaderboard {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'