# 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 Localizations API
  version: 1.0.0
extends: openapi/ios-gamecenterleaderboardlocalizations-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: 12
- target: $.paths['/v1/gameCenterLeaderboardLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a leaderboard localization (v1)
      effect: write
      questions:
      - How do I add a translated name for a leaderboard using the original v1 endpoint?
      - Can I localize a classic leaderboard's display name and score format for another language?
      instructions:
      - text: Create a v1 leaderboard localization with {localization}.
        slots:
          localization: requestBody.data
      - text: Add a language to my original leaderboard using {localization}.
        slots:
          localization: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard localization (v1)
      effect: read
      questions:
      - What does a v1 leaderboard localization contain for one language?
      - Can I fetch a classic leaderboard localization by its ID?
      instructions:
      - text: Get v1 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Fetch original leaderboard localization {localization} and include {include}.
        slots:
          localization: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard localization (v1)
      effect: destructive
      questions:
      - How do I remove a language from a leaderboard via the v1 localization endpoint?
      - Can I delete a classic leaderboard localization I added by mistake?
      instructions:
      - text: Delete v1 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Remove original leaderboard language entry {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard localization (v1)
      effect: write
      questions:
      - How do I fix the translated name on a v1 leaderboard localization?
      - Can I change the score formatting of a classic leaderboard localization?
      instructions:
      - text: Update v1 leaderboard localization {localization} with {changes}.
        slots:
          localization: path.id
          changes: requestBody.data
      - text: Edit original leaderboard language entry {localization} to {changes}.
        slots:
          localization: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a leaderboard localization (v2)
      effect: write
      questions:
      - What's the V2 way to add a translated leaderboard name?
      - Can I create a leaderboard localization with the newer v2 endpoint?
      instructions:
      - text: Create a v2 leaderboard localization with {localization}.
        slots:
          localization: requestBody.data
      - text: Add a language to a V2 leaderboard using {localization}.
        slots:
          localization: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard localization (v2)
      effect: read
      questions:
      - What does a V2 leaderboard localization look like for one language?
      - Can I read a leaderboard localization from the v2 endpoint by ID?
      instructions:
      - text: Get v2 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Fetch V2 leaderboard language entry {localization} including {include}.
        slots:
          localization: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard localization (v2)
      effect: destructive
      questions:
      - Which v2 call removes a language from a leaderboard?
      - Can I delete a V2 leaderboard localization?
      instructions:
      - text: Delete v2 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Remove V2 leaderboard language entry {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard localization (v2)
      effect: write
      questions:
      - Which v2 call edits a translated leaderboard name or description?
      - Can I update a V2 leaderboard localization's text?
      instructions:
      - text: Update v2 leaderboard localization {localization} with {changes}.
        slots:
          localization: path.id
          changes: requestBody.data
      - text: Edit V2 leaderboard language entry {localization} to {changes}.
        slots:
          localization: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardLocalizations/{id}/relationships/gameCenterLeaderboardImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image ID of a v1 leaderboard localization
      effect: read
      questions:
      - Which leaderboard image ID is tied to a v1 leaderboard localization?
      - Can I get just the image linkage for a classic leaderboard localization?
      instructions:
      - text: Return only the leaderboard image ID for v1 localization {localization}.
        slots:
          localization: path.id
      - text: Look up the image relationship of original leaderboard localization {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardLocalizations/{id}/gameCenterLeaderboardImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image of a v1 leaderboard localization
      effect: read
      questions:
      - What image, with its file details and upload state, is used for a v1 leaderboard localization?
      - Can I load the full leaderboard artwork record from a classic localization?
      instructions:
      - text: Show the full leaderboard image for v1 localization {localization}.
        slots:
          localization: path.id
      - text: Fetch the artwork and upload state for original leaderboard localization {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations/{id}/relationships/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image ID of a v2 leaderboard localization
      effect: read
      questions:
      - Which image ID is linked to a V2 leaderboard localization?
      - Can I get only the image linkage of a v2 leaderboard localization?
      instructions:
      - text: Return only the image ID for v2 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Look up the image relationship of V2 leaderboard language entry {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardLocalizations/{id}/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image of a v2 leaderboard localization
      effect: read
      questions:
      - What image file is attached to a V2 leaderboard localization, and has it finished uploading?
      - Can I load the full image record from a v2 leaderboard localization?
      instructions:
      - text: Show the full image for v2 leaderboard localization {localization}.
        slots:
          localization: path.id
      - text: Fetch artwork details for V2 leaderboard language entry {localization}.
        slots:
          localization: path.id
      method: generated
      generated: '2026-10-01'