What is a rate limit?
A rate limit is a cap on how much can be done in a set time, such as messages in a day, which keeps a service fair and an account safe.
In plain words
A motorway has a speed limit. It does not stop you travelling. It keeps everyone safe and the road moving. A rate limit does the same for messaging.
Every platform has its own idea of what normal looks like for a person. Send far more than a human would, and an account can be restricted. Limits keep your account inside what looks natural, so your business is still able to message tomorrow.
When you hit one, the service answers politely. It says no for now, says how long to wait and sends nothing. Waiting that long and then trying again is the right move. Looking for a way round the limit is not.
Limits are also kind to newer accounts. They start gently and rise as the account settles in, which is often called warm-up.
Think of a new employee who takes on a few clients in week one and a full list by the end of the month. Easing in is how trust is built, with people and with platforms.
How it works in Spaces
Spaces applies limits on its own side, so they hold whichever AI agent you use. They cover messages a day, new chats, the gap between sends and other actions, and they differ per channel. The numbers are on the Limits page.
A request over a limit is answered with 429, a retry_after_seconds value and a Retry-After header, and nothing is sent. Reading chats and messages still works, and a limit on one action does not use up another.
Related terms
- Daily limit: A daily limit is the most messages, or new conversations, an account is allowed to send in one day before sending stops until the next day.
- Pacing: Message pacing means leaving a gap between messages and capping how many go out in an hour and a day, so an account sends at a speed a person could.
- Warm-up: Warm-up means starting a new or newly connected account with only a few new conversations a day and increasing slowly over a few weeks, so the platform sees normal behaviour rather than a sudden burst.
- Retry: A retry is trying the same thing again after it failed, usually after a short wait, in case the problem was only temporary.
- Spend cap: A spend cap is a ceiling you set on how much can be used or spent in a month, so a busy period can never surprise you with a bigger bill.
FAQ
Why does a limit exist?
To keep your account within what the platform expects from a normal user, which lowers the risk of a restriction.
What should my agent do when it hits one?
Wait the retry_after_seconds it was given, then retry with the same Idempotency-Key.
Can I raise a limit by asking nicely?
Limits are set to protect the account, so Spaces does not remove them. They rise on their own as the account warms up.
Does a rate limit mean the message was lost?
No. Nothing was sent, and your agent can send it later.
Useful next: Sending limits, Account safety, Errors explained. Every term: the glossary.