Skip to content

Limits and expiry

These limits keep abandoned data and deliberate abuse from filling the shared database. They apply to the owner of a resource, even when an authorized service or administrator performs the request.

Bot-facing limits

Resource Default limit
Members in one owner's queue 100
Queue-member lifetime 72 hours
Free-user rules 10
Server-booster rules 15
Premium-user rules 20
Personal blacklist entries 250 per owner
Companions 50 per owner
Enabled queue contexts 100 per owner
Verification-required contexts 100 per owner
Stored lobby codes 100 per owner
Lobby-code lifetime 24 hours
Verified identities 10 per Discord user

Expired queue members and codes are removed automatically. Queue positions are normalized after expired entries are removed.

API token limits

An API identity can have one active token. Requests are limited per token in a fixed one-minute window:

Token class Default requests/minute
User 100
Administrator 300
Bot or service 1,000

A token's stored limit can be adjusted manually when needed. When a token exceeds its allowance, the API returns 429 Too Many Requests with Retry-After, X-RateLimit-Limit, and X-RateLimit-Remaining headers.

Storage-limit responses

The API returns 409 Conflict with structured details:

{
  "detail": {
    "code": "resource_limit_reached",
    "resource": "rules",
    "limit": 20
  }
}