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: