<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/rules",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Rules"
}
-->

# Rules

Manage the matchmaking rules that Game Center uses to find players.

## Discussion

The `rules` resource represents a matchmaking rule that Game Center applies to match requests in a queue.

With matchmaking rules, you have finer control over automatch of players to fill empty slots in a match request. For example, use matchmaking rules to find compatible players and assign them to teams using game-specific information, such as skill level and other criteria. During development, you use the matchmaking rules APIs to upload your rules to the Game Center server. In your game code, you configure match requests to use your set of matchmaking rules. When you submit the match requests, Game Center applies your rules to the collective match requests from multiple game instances in the queue to fill the empty slots.

For more information, see <doc://com.apple.documentation/documentation/GameKit/matchmaking-rules> in the GameKit framework.

## Topics

### Creating, modifying, and deleting rules

[`Create a Rule`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterMatchmakingRules)

Add a matchmaking rule to a rule set.

[`Modify a Rule`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterMatchmakingRules-_id_)

Update a specific matchmaking rule in a rule set.

[`Delete a Rule`](/documentation/AppStoreConnectAPI/DELETE-v1-gameCenterMatchmakingRules-_id_)

Delete a matchmaking rule in a rule set.

### Objects

[`object GameCenterMatchmakingRuleCreateRequest`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleCreateRequest)

The request body you use to create a rule.

[`object GameCenterMatchmakingRuleUpdateRequest`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleUpdateRequest)

The request body you use to modify a rule.

[`object GameCenterMatchmakingRuleResponse`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleResponse)

The response body for endpoints that create or modify a rule.

[`object GameCenterMatchmakingRule`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRule)

A JavaScript expression evaluated during Game Center matchmaking to determine player compatibility.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)