# 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 Activities API
  version: 1.0.0
extends: openapi/ios-gamecenteractivities-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['/v1/gameCenterActivities'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Game Center activity
      effect: write
      questions:
      - How do I set up a new Game Center activity for my game?
      - Can I create a Game Center activity through the App Store Connect API?
      instructions:
      - text: Create a Game Center activity with {activity}.
        slots:
          activity: requestBody.data
      - text: 'Add a new in-game activity to Game Center using these settings: {activity}.'
        slots:
          activity: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Game Center activity
      effect: read
      questions:
      - What are the settings of one Game Center activity?
      - Can I fetch an activity together with its linked achievements and leaderboards?
      instructions:
      - text: Get Game Center activity {activity}.
        slots:
          activity: path.id
      - text: Fetch activity {activity} and include {include}.
        slots:
          activity: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Game Center activity
      effect: destructive
      questions:
      - How do I permanently remove a Game Center activity I no longer use?
      - Can a Game Center activity be deleted once it's created?
      instructions:
      - text: Delete Game Center activity {activity}.
        slots:
          activity: path.id
      - text: Remove the activity {activity} from my game.
        slots:
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Game Center activity
      effect: write
      questions:
      - How do I change the settings on an existing Game Center activity?
      - Can I edit an activity's attributes after creating it?
      instructions:
      - text: Update Game Center activity {activity} with {changes}.
        slots:
          activity: path.id
          changes: requestBody.data
      - text: Change the attributes of activity {activity} to {changes}.
        slots:
          activity: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/achievements'].post
  update:
    x-apievangelist-phrasing:
      intent: Link achievements to an activity
      effect: write
      questions:
      - How do I attach existing achievements to a Game Center activity?
      - Can one activity reference several of my original achievements?
      instructions:
      - text: Link achievements {achievements} to activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      - text: Attach the original-format achievements {achievements} to Game Center activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/achievements'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink achievements from an activity
      effect: destructive
      questions:
      - How do I detach achievements from a Game Center activity without deleting them?
      - Can I remove the original-version achievement links from an activity?
      instructions:
      - text: Unlink achievements {achievements} from activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      - text: Detach the original-format achievements {achievements} from Game Center activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/achievementsV2'].post
  update:
    x-apievangelist-phrasing:
      intent: Link V2 achievements to an activity
      effect: write
      questions:
      - How do I attach the newer V2 achievements to a Game Center activity?
      - Can an activity reference achievements created with the V2 endpoints?
      instructions:
      - text: Link V2 achievements {achievements} to activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      - text: Add the version 2 achievement records {achievements} to Game Center activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/achievementsV2'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink V2 achievements from an activity
      effect: destructive
      questions:
      - How do I detach V2 achievements from a Game Center activity?
      - Can I drop the newer achievement links from an activity while keeping the achievements?
      instructions:
      - text: Unlink V2 achievements {achievements} from activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      - text: Remove the version 2 achievement records {achievements} from Game Center activity {activity}.
        slots:
          achievements: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/leaderboards'].post
  update:
    x-apievangelist-phrasing:
      intent: Link leaderboards to an activity
      effect: write
      questions:
      - How do I attach existing leaderboards to a Game Center activity?
      - Can an activity point at more than one of my original leaderboards?
      instructions:
      - text: Link leaderboards {leaderboards} to activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      - text: Attach the original-format leaderboards {leaderboards} to Game Center activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/leaderboards'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink leaderboards from an activity
      effect: destructive
      questions:
      - What's the way to take leaderboards off an activity while the leaderboards themselves stay intact?
      - Can I remove the original-version leaderboard links from an activity?
      instructions:
      - text: Unlink leaderboards {leaderboards} from activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      - text: Detach the original-format leaderboards {leaderboards} from Game Center activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/leaderboardsV2'].post
  update:
    x-apievangelist-phrasing:
      intent: Link V2 leaderboards to an activity
      effect: write
      questions:
      - Which call attaches the newer V2 leaderboards to a Game Center activity?
      - Can an activity reference leaderboards created with the V2 endpoints?
      instructions:
      - text: Link V2 leaderboards {leaderboards} to activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      - text: Add the version 2 leaderboard records {leaderboards} to Game Center activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/leaderboardsV2'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink V2 leaderboards from an activity
      effect: destructive
      questions:
      - Which call detaches V2 leaderboards from a Game Center activity?
      - Can I drop the newer leaderboard links from an activity while keeping the leaderboards?
      instructions:
      - text: Unlink V2 leaderboards {leaderboards} from activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      - text: Remove the version 2 leaderboard records {leaderboards} from Game Center activity {activity}.
        slots:
          leaderboards: requestBody.data
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/relationships/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List version IDs of a Game Center activity
      effect: read
      questions:
      - Which version IDs exist for a Game Center activity?
      - Can I get only the identifiers of an activity's versions?
      instructions:
      - text: List only the version IDs for activity {activity}.
        slots:
          activity: path.id
      - text: Return up to {limit} version identifiers of Game Center activity {activity}.
        slots:
          limit: query.limit
          activity: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterActivities/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the versions of a Game Center activity
      effect: read
      questions:
      - What versions of a Game Center activity exist, with their state and details?
      - Can I see each activity version along with its localizations and releases?
      instructions:
      - text: Show the full version records for Game Center activity {activity}.
        slots:
          activity: path.id
      - text: List the versions of activity {activity} and include {include}.
        slots:
          activity: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'