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

# Rule sets

Manage the rule sets that you add matchmaking rules and teams to.

## Discussion

The `rule set` resource represents a set of rules associated with a queue that Game Center applies to match requests in the queue. For more information, see <doc://com.apple.documentation/documentation/GameKit/matchmaking-rules> in the GameKit framework.

## Topics

### Creating, modifying, and deleting rule sets

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

Create a rule set to contain matchmaking rules and teams.

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

Update the attributes of a rule set.

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

Delete a rule set along with its matchmaking rules and teams.

### Reading rule set information

[`List All Rule Sets`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets)

Get information about all rule sets and their associated objects.

[`Read Rule Set Information`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_)

Get information about a specific rule set and its related objects.

[`List Queues in a Rule Set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-matchmakingQueues)

Get information about queues that belong to a rule set.

[`List matchmaking queue IDs for a Game Center matchmaking rule set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-relationships-matchmakingQueues)

[`List Rules in a Rule Set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-rules)

Get information about the rules in a rule set.

[`List rule IDs for a Game Center matchmaking rule set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-relationships-rules)

[`List Teams in a Rule Set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-teams)

Get information about the teams in a rule set.

[`List team IDs for a Game Center matchmaking rule set`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterMatchmakingRuleSets-_id_-relationships-teams)

### Objects

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

The request body you use to create a rule set.

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

The request body you use to modify a rule set.

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

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

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

The response body for endpoints that get multiple rule sets.

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

The response body for endpoints that get multiple rules.

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

A named collection of matchmaking rules and queues that defines the logic for matching players in a Game Center game.

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

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

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



---

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)