API Evangelist conversational phrasing for App Store Connect Game Center Achievements API

# 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 Achievements API
  version: 1.0.0
extends: openapi/ios-gamecenterachievements-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: 19
- target: $.paths['/v2/gameCenterAchievements'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an achievement (v2)
      effect: write
      questions:
      - How do I create a Game Center achievement with the v2 API?
      - Can I add a new achievement through the newer v2 endpoint?
      instructions:
      - text: Create a v2 Game Center achievement from {achievement_details}.
        slots:
          achievement_details: requestBody.data
      - text: Add a new achievement via v2 with {achievement_details}.
        slots:
          achievement_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an achievement (v2)
      effect: read
      questions:
      - What details does the v2 API return for one achievement?
      - Where can I look up a single achievement by ID on v2?
      instructions:
      - text: Fetch v2 achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Show achievement {achievement_id} from the v2 endpoint.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an achievement (v2)
      effect: destructive
      questions:
      - How do I delete an achievement using the v2 API?
      - Can a v2 Game Center achievement be removed permanently?
      instructions:
      - text: Delete v2 achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Remove achievement {achievement_id} with the v2 delete call.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an achievement (v2)
      effect: write
      questions:
      - How do I edit an existing achievement through v2?
      - Can I change an achievement's attributes with the v2 endpoint?
      instructions:
      - text: Update v2 achievement {achievement_id} with {changes}.
        slots:
          achievement_id: path.id
          changes: requestBody.data
      - text: Edit achievement {achievement_id} via v2.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an achievement (v1)
      effect: write
      questions:
      - How do I create an achievement with the legacy v1 Game Center API?
      - Can I still make achievements through the original v1 endpoint?
      instructions:
      - text: Create a v1 Game Center achievement from {achievement_details}.
        slots:
          achievement_details: requestBody.data
      - text: Use the legacy v1 endpoint to add an achievement with {achievement_details}.
        slots:
          achievement_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an achievement (v1)
      effect: read
      questions:
      - What does the legacy v1 endpoint return for one achievement?
      - How can I read a single achievement through v1?
      instructions:
      - text: Fetch v1 achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Get achievement {achievement_id} from the older v1 endpoint.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an achievement (v1)
      effect: destructive
      questions:
      - How do I delete an achievement using the legacy v1 API?
      - Can the original v1 call remove an achievement?
      instructions:
      - text: Delete v1 achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Remove achievement {achievement_id} with the legacy v1 endpoint.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an achievement (v1)
      effect: write
      questions:
      - How do I edit an achievement through the v1 API?
      - Can the legacy v1 endpoint modify an achievement's attributes?
      instructions:
      - text: Update v1 achievement {achievement_id} with {changes}.
        slots:
          achievement_id: path.id
          changes: requestBody.data
      - text: Modify achievement {achievement_id} via the older v1 update call.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}/relationships/activity'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link an achievement to an activity (v2)
      effect: write
      questions:
      - How do I attach a v2 achievement to a Game Center activity?
      - Can I change which activity an achievement belongs to using v2?
      instructions:
      - text: Link v2 achievement {achievement_id} to activity {activity}.
        slots:
          achievement_id: path.id
          activity: requestBody.data
      - text: Update the activity for achievement {achievement_id} through v2.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}/relationships/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List version IDs of an achievement (v2)
      effect: read
      questions:
      - How do I get only the version IDs of an achievement?
      - Which version identifiers are linked to a v2 achievement, without details?
      instructions:
      - text: List version IDs for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Get only the version linkages of v2 achievement {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterAchievements/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of an achievement (v2)
      effect: read
      questions:
      - What versions exist for an achievement, with full records?
      - Can I see every version of a Game Center achievement in detail?
      instructions:
      - text: Show the full version records of achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: List versions of v2 achievement {achievement_id} with details.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/relationships/activity'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link an achievement to an activity (v1)
      effect: write
      questions:
      - How do I attach an achievement to an activity with the legacy v1 API?
      - Can v1 change the activity linked to an achievement?
      instructions:
      - text: Link v1 achievement {achievement_id} to activity {activity}.
        slots:
          achievement_id: path.id
          activity: requestBody.data
      - text: Set the activity of achievement {achievement_id} via v1.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/relationships/groupAchievement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an achievement's group achievement ID
      effect: read
      questions:
      - How do I find the ID of the group achievement an achievement maps to?
      - Which group achievement is linked, as just an identifier?
      instructions:
      - text: Get the group achievement ID for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Show only the group achievement linkage of {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/relationships/groupAchievement'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link an achievement to a group achievement
      effect: write
      questions:
      - How do I connect an achievement to a group achievement?
      - Can I change which group achievement an achievement points to?
      instructions:
      - text: Link achievement {achievement_id} to group achievement {group_achievement}.
        slots:
          achievement_id: path.id
          group_achievement: requestBody.data
      - text: Update the group achievement for {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/groupAchievement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an achievement's group achievement
      effect: read
      questions:
      - What are the full details of the group achievement behind an achievement?
      - Can I read the group achievement record an achievement is tied to?
      instructions:
      - text: Show the full group achievement for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Fetch group achievement details of {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/relationships/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of an achievement
      effect: read
      questions:
      - How do I get only the localization IDs for an achievement?
      - Which localization identifiers are attached to an achievement?
      instructions:
      - text: List localization IDs for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Get only the localization linkages of achievement {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localizations of an achievement
      effect: read
      questions:
      - What localized titles and descriptions does an achievement have?
      - Can I see the full localization records for an achievement?
      instructions:
      - text: Show all localizations for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: List the translated text of achievement {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/relationships/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List release IDs of an achievement
      effect: read
      questions:
      - How do I get only the release IDs of an achievement?
      - Which release identifiers are linked to an achievement?
      instructions:
      - text: List release IDs for achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: Get only the release linkages of achievement {achievement_id}.
        slots:
          achievement_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterAchievements/{id}/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: List releases of an achievement
      effect: read
      questions:
      - Is my achievement live, and in which releases?
      - Can I filter an achievement's releases to only live ones?
      instructions:
      - text: Show the releases of achievement {achievement_id}.
        slots:
          achievement_id: path.id
      - text: List releases of achievement {achievement_id} where live is {live}.
        slots:
          achievement_id: path.id
          live: query.filter[live]
      method: generated
      generated: '2026-10-01'