<!--
{
  "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

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

The request body you use to create a rule.

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

The request body you use to modify a rule.

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

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

[`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)