# 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 Achievement Localizations API
  version: 1.0.0
extends: openapi/ios-gamecenterachievementlocalizations-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: 14
- target: $.paths['/v2/gameCenterAchievementLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to a Game Center achievement (V2)
      effect: write
      questions:
      - How do I add a French name and description to a Game Center achievement using the V2 localizations endpoint?
      - Can I create achievement localizations with the newer V2 resource instead of the original one?
      instructions:
      - text: Create a V2 achievement localization with {data}.
        slots:
          data: requestBody.data
      - text: Add a new language to my achievement through the V2 endpoint using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievementLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center achievement localization (V2)
      effect: read
      questions:
      - What localized title and descriptions does a V2 achievement localization hold?
      - Can I read one achievement localization through the V2 resource?
      instructions:
      - text: Show V2 achievement localization {id}.
        slots:
          id: path.id
      - text: Fetch the locale, name and descriptions of V2 localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievementLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center achievement localization (V2)
      effect: destructive
      questions:
      - Can I drop one language from an achievement using the V2 localizations resource?
      - Is removing a V2 achievement localization permanent?
      instructions:
      - text: Delete V2 achievement localization {id}.
        slots:
          id: path.id
      - text: Remove the language version {id} from my achievement via the V2 endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievementLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center achievement localization (V2)
      effect: write
      questions:
      - Can I fix a typo in an achievement's localized description using the V2 resource?
      - Which text fields of a V2 achievement localization are editable after creation?
      instructions:
      - text: Update V2 achievement localization {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Change the localized name and descriptions on V2 localization {id} to {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to a Game Center achievement (v1)
      effect: write
      questions:
      - How do I localize a Game Center achievement with the original v1 localizations endpoint?
      - Can I still create achievement localizations on the legacy v1 resource?
      instructions:
      - text: Create a v1 achievement localization with {data}.
        slots:
          data: requestBody.data
      - text: Add a language to my achievement using the older v1 endpoint and {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center achievement localization (v1)
      effect: read
      questions:
      - What does a legacy v1 achievement localization record contain?
      - Can I read an achievement localization through the original v1 resource?
      instructions:
      - text: Show v1 achievement localization {id}.
        slots:
          id: path.id
      - text: Fetch the locale and text of legacy v1 localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center achievement localization (v1)
      effect: destructive
      questions:
      - Can I remove an achievement language using the original v1 endpoint?
      - What happens when I delete a legacy v1 achievement localization?
      instructions:
      - text: Delete v1 achievement localization {id}.
        slots:
          id: path.id
      - text: Remove legacy localization {id} from its achievement.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center achievement localization (v1)
      effect: write
      questions:
      - Can I edit achievement text through the legacy v1 localization resource?
      - Which fields does the original v1 achievement localization let me change?
      instructions:
      - text: Update v1 achievement localization {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Edit the text of legacy localization {id} to {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievementLocalizations/{id}/relationships/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image ID for a V2 achievement localization
      effect: read
      questions:
      - Which image ID is linked to a V2 achievement localization?
      - Can I check only whether a V2 localization has an image reference?
      instructions:
      - text: Return only the image ID linked to V2 localization {id}.
        slots:
          id: path.id
      - text: Check the image linkage on V2 achievement localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievementLocalizations/{id}/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image for a V2 achievement localization
      effect: read
      questions:
      - What artwork is attached to a V2 achievement localization, and has it finished uploading?
      - Where do I see the full image record behind a localized achievement in the V2 model?
      instructions:
      - text: Show the full image record for V2 achievement localization {id}.
        slots:
          id: path.id
      - text: Fetch the achievement artwork and its upload state for V2 localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}/relationships/gameCenterAchievement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the achievement ID behind a v1 localization
      effect: read
      questions:
      - Which achievement ID does a v1 achievement localization belong to?
      - Can I get only the parent achievement reference for a legacy localization?
      instructions:
      - text: Return only the parent achievement ID of v1 localization {id}.
        slots:
          id: path.id
      - text: Check which achievement linkage legacy localization {id} has.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}/gameCenterAchievement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the achievement behind a v1 localization
      effect: read
      questions:
      - Which Game Center achievement, with its points and visibility, does this localization describe?
      - Can I load the full parent achievement from a legacy v1 localization?
      instructions:
      - text: Show the full achievement that v1 localization {id} belongs to.
        slots:
          id: path.id
      - text: Fetch the parent Game Center achievement details for localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}/relationships/gameCenterAchievementImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the achievement image ID for a v1 localization
      effect: read
      questions:
      - Which achievement image ID is linked to a legacy v1 localization?
      - Can I check just the image reference on an original-style achievement localization?
      instructions:
      - text: Return only the achievement image ID linked to v1 localization {id}.
        slots:
          id: path.id
      - text: Check the achievement image linkage on legacy localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievementLocalizations/{id}/gameCenterAchievementImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the achievement image for a v1 localization
      effect: read
      questions:
      - What image did I upload for a localized achievement under the legacy v1 model?
      - Has the achievement image on this v1 localization been delivered successfully?
      instructions:
      - text: Show the full achievement image for v1 localization {id}.
        slots:
          id: path.id
      - text: Fetch the legacy achievement image record and its delivery state for localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'