Discord error 20029: Server write rate limit

The same idea as 20028 but scoped to the whole guild. Discord caps the total volume of certain write actions a server can absorb in a window, and once the guild is over that threshold every further write of that kind is rejected regardless of which channel it targets.

This tends to appear during bulk operations: mass role changes, creating many channels or threads at once, a migration that rewrites permission overwrites, or a bot that fans out one message to every channel in a guild. The threshold is undocumented and varies; the only reliable signal is the retry_after value in the response.

Because the scope is the guild, your bot may be rate limited by activity from other bots in the same server. That is rare but worth remembering when the error appears without any change in your own traffic.

{
  "message": "The resource is being rate limited.",
  "retry_after": 25.0,
  "global": false,
  "code": 20029
}

Treat any "do X to every channel/role/member" feature as a background job with a rate-limited worker, progress tracking and idempotent steps. Never issue guild-wide writes with Promise.all or an unbounded thread pool.

Guild-wide write budgets punish concurrency hardest, so serialize setup and migration jobs. The REST bucket mechanics that sit underneath are in http 429, and chatbot API rate limiting covers making bulk jobs resumable.