pronounsfu/docs/api/ratelimits.md

2.2 KiB

Rate limits

The API has rate limits, generally separated by groups of endpoints. If you exceed a rate limit, the API will start to return 429 errors.

Headers

  • X-RateLimit-Bucket: the bucket the rate limit is for (listed below)
  • X-RateLimit-Limit: the total number of requests you can make per minute
  • X-RateLimit-Remaining: the number of requests remaining in the current timeframe
  • X-RateLimit-Reset: the unix timestamp that the number of requests resets at
  • Retry-After: only if you hit a rate limit, the number of seconds until you can make requests again

Buckets

Note that only the most specific matching bucket is used for rate limits.

Bucket Rate limit per minute Notes
/ 120 Used as fallback if no other bucket exists for the endpoint
GET /users/* 60
GET /users/*/members 60
GET /users/*/members/* 60
PATCH /users/@me 10
POST /members 10
GET /members/* 60
PATCH /members/* 20
DELETE /members/* 5
/auth/* 20
/auth/tokens 10
/auth/invites 10