# 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 Groups API
  version: 1.0.0
extends: openapi/ios-gamecentergroups-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: 29
- target: $.paths['/v1/gameCenterGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Game Center groups
      effect: read
      questions:
      - Which Game Center groups do I have set up in App Store Connect?
      - Can I find the Game Center group that a particular Game Center detail belongs to?
      instructions:
      - text: List all my Game Center groups.
      - text: Find the Game Center groups tied to Game Center detail {detail}.
        slots:
          detail: query.filter[gameCenterDetails]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Game Center group
      effect: write
      questions:
      - How do I create a Game Center group so several games can share leaderboards and achievements?
      - Can I set up a new shared Game Center group through the API?
      instructions:
      - text: Create a new Game Center group with reference name {group}.
        slots:
          group: requestBody.data
      - text: Set up a Game Center group so my apps can share Game Center data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center group
      effect: read
      questions:
      - What does a single Game Center group look like, including its reference name?
      - Can I look up one Game Center group by its ID?
      instructions:
      - text: Show me Game Center group {id}.
        slots:
          id: path.id
      - text: Fetch the details of Game Center group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center group
      effect: destructive
      questions:
      - Can I delete a Game Center group I no longer need?
      - What happens when I remove a Game Center group from App Store Connect?
      instructions:
      - text: Delete Game Center group {id}.
        slots:
          id: path.id
      - text: Remove the Game Center group {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center group
      effect: write
      questions:
      - Can I rename a Game Center group after creating it?
      - How do I change the reference name on an existing Game Center group?
      instructions:
      - text: Rename Game Center group {id} to {group}.
        slots:
          id: path.id
          group: requestBody.data
      - text: Update the settings of Game Center group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterAchievements'].get
  update:
    x-apievangelist-phrasing:
      intent: List achievement IDs linked to a group
      effect: read
      questions:
      - Which achievement IDs are linked to my Game Center group?
      - Can I get just the achievement identifiers attached to a group, without full details?
      instructions:
      - text: List the achievement IDs linked to Game Center group {id}.
        slots:
          id: path.id
      - text: Give me only the achievement linkage IDs for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterAchievements'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's achievements
      effect: write
      questions:
      - How do I reorder or swap the achievements assigned to a Game Center group?
      - Can I set the full list of achievements in a group in one call?
      instructions:
      - text: Replace the achievements in Game Center group {id} with {achievements}.
        slots:
          id: path.id
          achievements: requestBody.data
      - text: 'Reset the achievement list for group {id} to exactly these achievements: {achievements}.'
        slots:
          id: path.id
          achievements: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterAchievements'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's achievements
      effect: read
      questions:
      - What achievements are in my Game Center group, with their names and details?
      - Can I filter a group's achievements to only archived ones?
      instructions:
      - text: Show the full achievements in Game Center group {id}.
        slots:
          id: path.id
      - text: List achievements in group {id} with reference name {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      - text: Show archived achievements in group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterAchievementsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List V2 achievement IDs linked to a group
      effect: read
      questions:
      - Which V2 achievement IDs are linked to a Game Center group?
      - Can I fetch only the identifiers of a group's V2 achievements?
      instructions:
      - text: Fetch only the identifiers of V2 achievements referenced by group {id}.
        slots:
          id: path.id
      - text: Get the V2 achievement linkages for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterAchievementsV2'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's V2 achievements
      effect: write
      questions:
      - How do I set the V2 achievements that belong to a Game Center group?
      - Can I overwrite a group's V2 achievement list in a single request?
      instructions:
      - text: Overwrite group {id}'s newer V2 achievements using {achievements}.
        slots:
          id: path.id
          achievements: requestBody.data
      - text: Set group {id}'s V2 achievement list to {achievements}.
        slots:
          id: path.id
          achievements: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterAchievementsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's V2 achievements
      effect: read
      questions:
      - What V2 achievements does my Game Center group contain, with full details?
      - Can I search a group's V2 achievements by reference name?
      instructions:
      - text: Display every V2 achievement record that group {id} contains.
        slots:
          id: path.id
      - text: Find V2 achievements in group {id} named {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterActivities'].get
  update:
    x-apievangelist-phrasing:
      intent: List activity IDs linked to a group
      effect: read
      questions:
      - Which Game Center activity IDs are linked to my group?
      - Can I get just the activity identifiers for a Game Center group?
      instructions:
      - text: List the activity IDs linked to Game Center group {id}.
        slots:
          id: path.id
      - text: Get the activity linkages for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterActivities'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's activities
      effect: read
      questions:
      - What Game Center activities are part of my group, with their full details?
      - Can I see every activity configured in a Game Center group?
      instructions:
      - text: Show the full activities in Game Center group {id}.
        slots:
          id: path.id
      - text: List up to {limit} activities from group {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterChallenges'].get
  update:
    x-apievangelist-phrasing:
      intent: List challenge IDs linked to a group
      effect: read
      questions:
      - Which challenge IDs are linked to a Game Center group?
      - Can I pull only the identifiers of the challenges in a group?
      instructions:
      - text: List the challenge IDs linked to Game Center group {id}.
        slots:
          id: path.id
      - text: Get the challenge linkages for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterChallenges'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's challenges
      effect: read
      questions:
      - What Game Center challenges are in my group, with names and settings?
      - Can I filter a group's challenges to archived ones only?
      instructions:
      - text: Show the full challenges in Game Center group {id}.
        slots:
          id: path.id
      - text: Find challenges in group {id} with reference name {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List Game Center detail IDs in a group
      effect: read
      questions:
      - Which Game Center detail IDs belong to my group?
      - Can I get just the identifiers of the apps' Game Center details in a group?
      instructions:
      - text: List the Game Center detail IDs linked to group {id}.
        slots:
          id: path.id
      - text: Get the Game Center detail linkages for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List the Game Center details in a group
      effect: read
      questions:
      - Which apps' Game Center details share this Game Center group?
      - Can I only show group members whose Game Center app versions are enabled?
      instructions:
      - text: Show the full Game Center details that share group {id}.
        slots:
          id: path.id
      - text: List Game Center details in group {id} where app versions enabled is {enabled}.
        slots:
          id: path.id
          enabled: query.filter[gameCenterAppVersions.enabled]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboard set IDs linked to a group
      effect: read
      questions:
      - What leaderboard set identifiers are attached to my Game Center group?
      - Can I get only the identifiers of a group's leaderboard sets?
      instructions:
      - text: Return leaderboard set identifiers attached to Game Center group {id}.
        slots:
          id: path.id
      - text: Give me only the IDs of leaderboard sets that group {id} points to.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSets'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's leaderboard sets
      effect: write
      questions:
      - How do I change which leaderboard sets belong to a Game Center group?
      - Can I reorder a group's leaderboard sets by replacing the list?
      instructions:
      - text: Replace the leaderboard sets in Game Center group {id} with {sets}.
        slots:
          id: path.id
          sets: requestBody.data
      - text: Set group {id}'s leaderboard sets to exactly {sets}.
        slots:
          id: path.id
          sets: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterLeaderboardSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's leaderboard sets
      effect: read
      questions:
      - What leaderboard sets are in my Game Center group, with full details?
      - Can I look up a group's leaderboard set by its reference name?
      instructions:
      - text: Show the full leaderboard sets in Game Center group {id}.
        slots:
          id: path.id
      - text: Find leaderboard sets in group {id} named {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSetsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List V2 leaderboard set IDs in a group
      effect: read
      questions:
      - Can I see which V2 sets a group references, IDs only?
      - Can I fetch only identifiers for a group's V2 leaderboard sets?
      instructions:
      - text: Fetch only identifiers of V2 leaderboard sets referenced by group {id}.
        slots:
          id: path.id
      - text: Pull V2 set linkage references for Game Center group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardSetsV2'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's V2 leaderboard sets
      effect: write
      questions:
      - How do I set the V2 leaderboard sets that belong to a Game Center group?
      - Can I overwrite a group's V2 leaderboard set list at once?
      instructions:
      - text: Overwrite group {id}'s newer V2 leaderboard sets using {sets}.
        slots:
          id: path.id
          sets: requestBody.data
      - text: Set group {id}'s V2 leaderboard sets to {sets}.
        slots:
          id: path.id
          sets: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterLeaderboardSetsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's V2 leaderboard sets
      effect: read
      questions:
      - What V2 leaderboard sets does my Game Center group contain, in full?
      - Can I search a group's V2 leaderboard sets by reference name?
      instructions:
      - text: Display every V2 leaderboard set record that group {id} contains.
        slots:
          id: path.id
      - text: Look up group {id}'s V2 sets by reference name {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboard IDs linked to a group
      effect: read
      questions:
      - Which leaderboard IDs are linked to my Game Center group?
      - Can I get just the leaderboard identifiers attached to a group?
      instructions:
      - text: List individual leaderboard IDs linked to group {id}, not sets.
        slots:
          id: path.id
      - text: Get leaderboard relationship references for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboards'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's leaderboards
      effect: write
      questions:
      - How do I change the leaderboards assigned to a Game Center group?
      - Can I replace a group's whole leaderboard list in one request?
      instructions:
      - text: Replace the leaderboards in Game Center group {id} with {leaderboards}.
        slots:
          id: path.id
          leaderboards: requestBody.data
      - text: Set group {id}'s leaderboards to exactly {leaderboards}.
        slots:
          id: path.id
          leaderboards: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's leaderboards
      effect: read
      questions:
      - What leaderboards are in my Game Center group, with names and settings?
      - Can I exclude archived leaderboards when listing a group's leaderboards?
      instructions:
      - text: Show the full leaderboards in Game Center group {id}.
        slots:
          id: path.id
      - text: Find leaderboards in group {id} with reference name {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List V2 leaderboard IDs linked to a group
      effect: read
      questions:
      - Which V2 leaderboard IDs are linked to a Game Center group?
      - Can I fetch only identifiers for a group's V2 leaderboards?
      instructions:
      - text: Fetch only identifiers of V2 leaderboards referenced by group {id}.
        slots:
          id: path.id
      - text: Get the V2 leaderboard linkages for group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/relationships/gameCenterLeaderboardsV2'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a group's V2 leaderboards
      effect: write
      questions:
      - Which call swaps out every V2 leaderboard a Game Center group uses?
      - Is it possible to reassign all V2 leaderboards in one group together?
      instructions:
      - text: Overwrite group {id}'s newer V2 leaderboards using {leaderboards}.
        slots:
          id: path.id
          leaderboards: requestBody.data
      - text: Make {leaderboards} the only V2 leaderboards assigned to group {id}.
        slots:
          id: path.id
          leaderboards: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterGroups/{id}/gameCenterLeaderboardsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's V2 leaderboards
      effect: read
      questions:
      - What V2 leaderboards does my Game Center group contain, in full?
      - Can I filter a group's V2 leaderboards to archived ones?
      instructions:
      - text: Pull full details for each individual V2 leaderboard inside group {id}.
        slots:
          id: path.id
      - text: Find V2 leaderboards in group {id} named {name}.
        slots:
          id: path.id
          name: query.filter[referenceName]
      method: generated
      generated: '2026-10-01'