# 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 Matchmaking Queues API
  version: 1.0.0
extends: openapi/ios-gamecentermatchmakingqueues-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: 10
- target: $.paths['/v1/gameCenterMatchmakingQueues'].get
  update:
    x-apievangelist-phrasing:
      intent: List matchmaking queues
      effect: read
      questions:
      - What Game Center matchmaking queues do I have?
      - Can I list all my rule-based matchmaking queues in one call?
      instructions:
      - text: List my Game Center matchmaking queues.
      - text: Show {limit} matchmaking queues.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a matchmaking queue
      effect: write
      questions:
      - How do I create a new matchmaking queue for my game?
      - What do I send to set up a Game Center matchmaking queue?
      instructions:
      - text: Create a matchmaking queue with {data}.
        slots:
          data: requestBody.data
      - text: Set up a new Game Center matchmaking queue using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a matchmaking queue
      effect: read
      questions:
      - Can I look up one matchmaking queue by ID?
      - What rule set and settings does a given matchmaking queue use?
      instructions:
      - text: Show matchmaking queue {id}.
        slots:
          id: path.id
      - text: Fetch matchmaking queue {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a matchmaking queue
      effect: destructive
      questions:
      - How do I remove a matchmaking queue I no longer use?
      - Can a Game Center matchmaking queue be deleted?
      instructions:
      - text: Delete matchmaking queue {id}.
        slots:
          id: path.id
      - text: Remove the Game Center matchmaking queue {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a matchmaking queue
      effect: write
      questions:
      - Can I change the rule set or settings of an existing matchmaking queue?
      - How do I edit a matchmaking queue after creating it?
      instructions:
      - text: Update matchmaking queue {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Change the settings of matchmaking queue {id} to {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}/metrics/experimentMatchmakingQueueSizes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get experiment queue size metrics
      effect: read
      questions:
      - How big is the experiment queue for my matchmaking test over time?
      - Can I see queue size metrics for the experimental rule set?
      instructions:
      - text: Show experiment queue sizes for queue {id} at {granularity} granularity.
        slots:
          id: path.id
          granularity: query.granularity
      - text: Get experimental queue size history for {id} per {granularity}, sorted by {sort}.
        slots:
          id: path.id
          granularity: query.granularity
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}/metrics/experimentMatchmakingRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: Get experiment matchmaking request metrics
      effect: read
      questions:
      - How many matchmaking requests went through my experiment rule set?
      - Can I break down experiment matchmaking requests by result?
      instructions:
      - text: Show experiment matchmaking request counts for queue {id} per {granularity}.
        slots:
          id: path.id
          granularity: query.granularity
      - text: Get experiment requests for queue {id} by {granularity} where result is {result}.
        slots:
          id: path.id
          granularity: query.granularity
          result: query.filter[result]
      - text: Show experiment requests for queue {id} per {granularity} from game {game}.
        slots:
          id: path.id
          granularity: query.granularity
          game: query.filter[gameCenterDetail]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}/metrics/matchmakingQueueSizes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get matchmaking queue size metrics
      effect: read
      questions:
      - How many players are waiting in my matchmaking queue over time?
      - Can I chart live queue sizes hourly or daily?
      instructions:
      - text: Show live queue sizes for matchmaking queue {id} at {granularity} granularity.
        slots:
          id: path.id
          granularity: query.granularity
      - text: Get the queue size trend for {id} every {granularity}, sorted by {sort}.
        slots:
          id: path.id
          granularity: query.granularity
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}/metrics/matchmakingRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: Get matchmaking request metrics
      effect: read
      questions:
      - How many matchmaking requests does my queue receive and how many succeed?
      - Can I filter matchmaking request metrics to a single game?
      instructions:
      - text: Show matchmaking request metrics for queue {id} per {granularity}.
        slots:
          id: path.id
          granularity: query.granularity
      - text: Get matchmaking requests for queue {id} by {granularity}, grouped by {groupBy}.
        slots:
          id: path.id
          granularity: query.granularity
          groupBy: query.groupBy
      - text: Show matchmaking requests on queue {id} per {granularity} for game {game}.
        slots:
          id: path.id
          granularity: query.granularity
          game: query.filter[gameCenterDetail]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingQueues/{id}/metrics/matchmakingSessions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get matchmaking session metrics
      effect: read
      questions:
      - How many matchmaking sessions did my queue create?
      - What does session activity look like for a matchmaking queue over time?
      instructions:
      - text: Show matchmaking session metrics for queue {id} at {granularity} granularity.
        slots:
          id: path.id
          granularity: query.granularity
      - text: Get the session count for matchmaking queue {id} every {granularity}.
        slots:
          id: path.id
          granularity: query.granularity
      method: generated
      generated: '2026-10-01'