Discord error 20022: Announcement rate limit on message edit

The message lives in an announcement channel (type 5, GUILD_ANNOUNCEMENT) and has been published (crossposted) to following servers. Discord limits how often a published message can be edited because every edit fans out to every follower channel. When you exceed that, edits are refused with 20022.

This is not a permissions problem and your bot is not misconfigured. It is a deliberate protection on the publish mechanism. Bots that post a status board or live-updating embed to an announcement channel and patch it every few seconds are the typical victims. The limit applies to the specific published message, so a new message is unaffected.

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

Check channel.type === 5 before wiring any auto-updating message, and route such messages elsewhere. Also check the message's flags for CROSSPOSTED (1 << 1) before scheduling edits, and apply a much slower edit cadence when set.

If you cannot avoid editing published messages, keep a per-message edit counter and timestamp in memory so you can see how close you are to the cap, and prefer deleting and re-publishing over many small edits when the content has changed substantially.

Announcement channels trade edit freedom for fan-out reach, so treat published messages as write-once. The related ceiling on editing any message older than an hour, 30046, catches the same live-dashboard designs; pacing strategies for both are in chatbot API rate limiting.