Matchmaking

Create Matchmaking Queue

Create new matchmaking queue

Body example: { "name": "PvP Matchmaking", "type": "competitive", "criteria": { "required": ["user.data.profile.level"], "optional": ["user.data.stats.rating"] }, "tolerance": { "level_range": 5, "rating_range": 100, "max_wait_seconds": 30 }, "room_config": { "auto_create": true, "capacity": 2, "type": "pvp_match", "existing_room_id": "room_abc" }, "tiers": { "bronze": {"level_min": 1, "level_max": 10}, "silver": {"level_min": 11, "level_max": 25} } }

If room_config.auto_create is false, set room_config.existing_room_id to a stream_relay room id that already exists in the same project as the queue.

post/api/matchmaking/queues

Request

  • Base URL: https://api.agentstack.tech (the document declares no server; this is the origin it was published from)
  • URL: https://api.agentstack.tech/api/matchmaking/queues
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

Idempotency-Keystring

Client-generated key to make mutating requests idempotent.

Request body

idstring nullable
namestring required
typestring
criteriaobject
matching_strategystring
toleranceobject
room_configobject
tiersobject nullable
min_match_scorenumber

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.