# 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 Leaderboard Sets API
  version: 1.0.0
extends: openapi/ios-gamecenterleaderboardsets-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: 27
- target: $.paths['/v2/gameCenterLeaderboardSets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a leaderboard set (v2)
      effect: write
      questions:
      - How do I group several Game Center leaderboards into a set using the v2 API?
      - Can I create a leaderboard set through the newer v2 leaderboard set endpoint?
      instructions:
      - text: Create a v2 Game Center leaderboard set from {set_details}.
        slots:
          set_details: requestBody.data
      - text: Use the v2 endpoint to add a new leaderboard set with {set_details}.
        slots:
          set_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard set (v2)
      effect: read
      questions:
      - What details does the v2 API return for a single leaderboard set?
      - Where can I look up one Game Center leaderboard set by ID on v2?
      instructions:
      - text: Fetch v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Show me the details of leaderboard set {set_id} from the v2 endpoint.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard set (v2)
      effect: destructive
      questions:
      - How do I remove a leaderboard set with the v2 API?
      - Can a v2 Game Center leaderboard set be deleted permanently?
      instructions:
      - text: Delete v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Remove leaderboard set {set_id} using the v2 delete endpoint.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard set (v2)
      effect: write
      questions:
      - How do I rename or edit an existing leaderboard set via v2?
      - Can I change the attributes of a v2 leaderboard set after creating it?
      instructions:
      - text: Update v2 leaderboard set {set_id} with {changes}.
        slots:
          set_id: path.id
          changes: requestBody.data
      - text: Edit the v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a leaderboard set (v1)
      effect: write
      questions:
      - How do I create a leaderboard set with the original v1 Game Center API?
      - Can I still make a leaderboard set through the legacy v1 endpoint?
      instructions:
      - text: Create a v1 Game Center leaderboard set from {set_details}.
        slots:
          set_details: requestBody.data
      - text: Use the legacy v1 endpoint to make a leaderboard set with {set_details}.
        slots:
          set_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard set (v1)
      effect: read
      questions:
      - What does the legacy v1 endpoint return for one leaderboard set?
      - How can I read a single leaderboard set through the v1 API?
      instructions:
      - text: Fetch v1 leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Get leaderboard set {set_id} from the older v1 endpoint.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard set (v1)
      effect: destructive
      questions:
      - How do I delete a leaderboard set using the legacy v1 API?
      - Can I remove a leaderboard set through the original v1 delete call?
      instructions:
      - text: Delete v1 leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Remove leaderboard set {set_id} with the legacy v1 endpoint.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard set (v1)
      effect: write
      questions:
      - How do I edit a leaderboard set's attributes through the v1 API?
      - Can the legacy v1 endpoint modify an existing leaderboard set?
      instructions:
      - text: Update v1 leaderboard set {set_id} with {changes}.
        slots:
          set_id: path.id
          changes: requestBody.data
      - text: Modify leaderboard set {set_id} via the older v1 update call.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboard IDs in a set (v2)
      effect: read
      questions:
      - How do I get just the IDs of the leaderboards inside a v2 leaderboard set?
      - Which leaderboard identifiers are linked to a v2 set, without full details?
      instructions:
      - text: List the leaderboard IDs linked to v2 set {set_id}.
        slots:
          set_id: path.id
      - text: Get only the leaderboard linkages for v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].post
  update:
    x-apievangelist-phrasing:
      intent: Add leaderboards to a set (v2)
      effect: write
      questions:
      - How do I add more leaderboards to an existing v2 leaderboard set?
      - Can I attach extra leaderboards to a v2 set without replacing the current ones?
      instructions:
      - text: Add leaderboards {leaderboards} to v2 set {set_id}.
        slots:
          leaderboards: requestBody.data
          set_id: path.id
      - text: Attach more leaderboards to v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove leaderboards from a set (v2)
      effect: destructive
      questions:
      - How do I take specific leaderboards out of a v2 leaderboard set?
      - Can I detach a leaderboard from a v2 set without deleting the leaderboard itself?
      instructions:
      - text: Remove leaderboards {leaderboards} from v2 set {set_id}.
        slots:
          leaderboards: requestBody.data
          set_id: path.id
      - text: Detach leaderboards from v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a set's leaderboards (v2)
      effect: write
      questions:
      - How do I overwrite the full list of leaderboards in a v2 set?
      - Can I reorder or swap out every leaderboard in a v2 leaderboard set at once?
      instructions:
      - text: Replace the leaderboards in v2 set {set_id} with {leaderboards}.
        slots:
          set_id: path.id
          leaderboards: requestBody.data
      - text: Set the complete leaderboard list for v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboards in a set (v2)
      effect: read
      questions:
      - What leaderboards, with full details, belong to a v2 leaderboard set?
      - Can I filter the leaderboards in a v2 set by reference name or archived status?
      instructions:
      - text: Show the full leaderboards in v2 set {set_id}.
        slots:
          set_id: path.id
      - text: List leaderboards named {reference_name} in v2 set {set_id}.
        slots:
          reference_name: query.filter[referenceName]
          set_id: path.id
      - text: Show archived leaderboards in v2 set {set_id} where archived is {archived}.
        slots:
          set_id: path.id
          archived: query.filter[archived]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/relationships/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List version IDs of a set (v2)
      effect: read
      questions:
      - How do I get only the version IDs of a v2 leaderboard set?
      - Which version identifiers are linked to a leaderboard set, without full records?
      instructions:
      - text: Return only the version IDs referencing v2 leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Get version linkages only for leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSets/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a set (v2)
      effect: read
      questions:
      - What versions exist for a v2 leaderboard set, with full details?
      - Can I see every version record of a Game Center leaderboard set?
      instructions:
      - text: Show the full version records for leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: List versions of v2 leaderboard set {set_id} with their details.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboard IDs in a set (v1)
      effect: read
      questions:
      - How do I get just the leaderboard IDs in a set through the legacy v1 API?
      - Which leaderboard linkages does the v1 relationship endpoint return for a set?
      instructions:
      - text: List leaderboard IDs linked to v1 set {set_id}.
        slots:
          set_id: path.id
      - text: Get only leaderboard linkages for leaderboard set {set_id} via v1.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].post
  update:
    x-apievangelist-phrasing:
      intent: Add leaderboards to a set (v1)
      effect: write
      questions:
      - How do I add leaderboards to a set with the legacy v1 API?
      - Can the v1 endpoint attach additional leaderboards to a leaderboard set?
      instructions:
      - text: Add leaderboards {leaderboards} to v1 set {set_id}.
        slots:
          leaderboards: requestBody.data
          set_id: path.id
      - text: Attach leaderboards to leaderboard set {set_id} using v1.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove leaderboards from a set (v1)
      effect: destructive
      questions:
      - How do I remove leaderboards from a set using the legacy v1 API?
      - Can v1 detach a leaderboard from a set while keeping the leaderboard?
      instructions:
      - text: Remove leaderboards {leaderboards} from v1 set {set_id}.
        slots:
          leaderboards: requestBody.data
          set_id: path.id
      - text: Detach leaderboards from leaderboard set {set_id} through v1.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace a set's leaderboards (v1)
      effect: write
      questions:
      - How do I replace all leaderboards in a set with the v1 API?
      - Can the legacy v1 call overwrite a leaderboard set's full membership?
      instructions:
      - text: Replace the leaderboards in v1 set {set_id} with {leaderboards}.
        slots:
          set_id: path.id
          leaderboards: requestBody.data
      - text: Overwrite the leaderboard list of set {set_id} using v1.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/gameCenterLeaderboards'].get
  update:
    x-apievangelist-phrasing:
      intent: List leaderboards in a set (v1)
      effect: read
      questions:
      - What full leaderboard records does the v1 API return for a set?
      - Can I filter a v1 set's leaderboards by ID or archived state?
      instructions:
      - text: Show the full leaderboards in v1 set {set_id}.
        slots:
          set_id: path.id
      - text: List leaderboards {leaderboard_ids} within v1 set {set_id}.
        slots:
          leaderboard_ids: query.filter[id]
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/groupLeaderboardSet'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a set's group set ID
      effect: read
      questions:
      - How do I find the ID of the group leaderboard set a set belongs to?
      - Which group leaderboard set is linked to this set, as just an identifier?
      instructions:
      - text: Get the group leaderboard set ID for set {set_id}.
        slots:
          set_id: path.id
      - text: Show only the group set linkage of leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/groupLeaderboardSet'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link a set to a group leaderboard set
      effect: write
      questions:
      - How do I connect a leaderboard set to a group leaderboard set?
      - Can I change which group leaderboard set a set is linked to?
      instructions:
      - text: Link leaderboard set {set_id} to group set {group_set}.
        slots:
          set_id: path.id
          group_set: requestBody.data
      - text: Update the group leaderboard set for set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/groupLeaderboardSet'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a set's group leaderboard set
      effect: read
      questions:
      - What are the full details of the group leaderboard set behind a set?
      - Can I read the group leaderboard set record that a set points to?
      instructions:
      - text: Show the full group leaderboard set for set {set_id}.
        slots:
          set_id: path.id
      - text: Fetch the group leaderboard set details of leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of a set
      effect: read
      questions:
      - How do I get just the localization IDs for a leaderboard set?
      - Which localization identifiers are attached to a set, without the text?
      instructions:
      - text: List localization IDs for leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Get only the localization linkages of set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localizations of a set
      effect: read
      questions:
      - What localized names does a leaderboard set have in each language?
      - Can I see the full localization records for a leaderboard set?
      instructions:
      - text: Show all localizations for leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: List the translated names of leaderboard set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/relationships/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List release IDs of a set
      effect: read
      questions:
      - How do I get only the release IDs of a leaderboard set?
      - Which release identifiers are linked to a set, without full records?
      instructions:
      - text: List release IDs for leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: Get only the release linkages of set {set_id}.
        slots:
          set_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSets/{id}/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List releases of a set
      effect: read
      questions:
      - Is my leaderboard set live, and in which releases?
      - Can I filter a leaderboard set's releases to only the live ones?
      instructions:
      - text: Show the releases of leaderboard set {set_id}.
        slots:
          set_id: path.id
      - text: List releases of set {set_id} where live is {live}.
        slots:
          set_id: path.id
          live: query.filter[live]
      method: generated
      generated: '2026-10-01'