# 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 Rules API
  version: 1.0.0
extends: openapi/ios-gamecentermatchmakingrules-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: 6
- target: $.paths['/v1/gameCenterMatchmakingRules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a matchmaking rule
      effect: write
      questions:
      - How do I add a matchmaking rule to a Game Center rule set?
      - Can I define a new rule that filters which players get matched?
      instructions:
      - text: Create a matchmaking rule with {rule_details}.
        slots:
          rule_details: requestBody.data
      - text: Add a new Game Center matchmaking rule from {rule_details}.
        slots:
          rule_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingRules/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a matchmaking rule
      effect: destructive
      questions:
      - How do I remove a matchmaking rule?
      - Can a rule be deleted from a matchmaking rule set?
      instructions:
      - text: Delete matchmaking rule {rule_id}.
        slots:
          rule_id: path.id
      - text: Remove Game Center rule {rule_id}.
        slots:
          rule_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingRules/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a matchmaking rule
      effect: write
      questions:
      - How do I change a matchmaking rule's expression or weight?
      - Can I edit an existing matchmaking rule?
      instructions:
      - text: Update matchmaking rule {rule_id} with {changes}.
        slots:
          rule_id: path.id
          changes: requestBody.data
      - text: Edit Game Center rule {rule_id}.
        slots:
          rule_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingRules/{id}/metrics/matchmakingBooleanRuleResults'].get
  update:
    x-apievangelist-phrasing:
      intent: Get boolean rule result metrics
      effect: read
      questions:
      - How often does my boolean matchmaking rule evaluate true versus false?
      - Can I break down boolean rule results by queue over time?
      instructions:
      - text: Get boolean result metrics for rule {rule_id} at {granularity} granularity.
        slots:
          rule_id: path.id
          granularity: query.granularity
      - text: Show boolean rule results for {rule_id} where result is {result}, by {granularity}.
        slots:
          rule_id: path.id
          result: query.filter[result]
          granularity: query.granularity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingRules/{id}/metrics/matchmakingNumberRuleResults'].get
  update:
    x-apievangelist-phrasing:
      intent: Get number rule result metrics
      effect: read
      questions:
      - What values does my numeric matchmaking rule produce over time?
      - Can I see number rule results for a specific matchmaking queue?
      instructions:
      - text: Get number result metrics for rule {rule_id} at {granularity} granularity.
        slots:
          rule_id: path.id
          granularity: query.granularity
      - text: Show number rule results for {rule_id} in queue {queue}, by {granularity}.
        slots:
          rule_id: path.id
          queue: query.filter[gameCenterMatchmakingQueue]
          granularity: query.granularity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterMatchmakingRules/{id}/metrics/matchmakingRuleErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: Get matchmaking rule error metrics
      effect: read
      questions:
      - Is my matchmaking rule throwing errors, and how often?
      - Can I track rule evaluation errors per queue over time?
      instructions:
      - text: Get error metrics for matchmaking rule {rule_id} at {granularity} granularity.
        slots:
          rule_id: path.id
          granularity: query.granularity
      - text: Show rule errors for {rule_id} in queue {queue}, by {granularity}.
        slots:
          rule_id: path.id
          queue: query.filter[gameCenterMatchmakingQueue]
          granularity: query.granularity
      method: generated
      generated: '2026-10-01'