Getting started
Limits
Your workspace's plan has its own allowances, such as how many people, files and runner minutes it includes. Those are on Plans and billing.
SpudSuite also keeps everyone's workspace quick by limiting how much one person, workspace, key or address can do in a short while. Day to day you won't meet them: they're set well above what a busy team does, and they're there to stop runaway scripts and people trying to break in.
When you go over
If you do go over, SpudSuite says so in plain words and tells you how long to wait, such as "You're sending messages faster than Spud can read them. Try again in 12 seconds." Nothing you typed is lost: a Chat message stays in the box, ready to send again.
Wait the time it says, then try again. Limits refill steadily, so you don't have to wait for a whole hour to pass before doing anything.
What's limited
These are the usual limits. Whoever runs your SpudSuite can change them.
| What | Usual limit | Counted for |
|---|---|---|
| Sign-in codes | 60 per 15 minutes, and 5 per email address | Each internet address |
| Tries at a code or password | 60 to 100 per 15 minutes | Each internet address |
| New workspaces | 10 per hour | You |
| Invitation emails | 200 per day | You |
| Chat messages | 60 per minute | You |
| New channels and direct messages | 30 per hour | You |
| Uploads | 60 per minute for you, 2,000 per hour for the workspace | You and your workspace |
| Assistant messages | 20 per minute for you, 600 per hour for the workspace | You and your workspace |
| Factory messages and projects | 30 messages per minute and 20 projects per hour for you, 300 per hour for the workspace | You and your workspace |
| Anything else you change | 600 per minute | You |
Agents have their own: see API keys for scripts and CI, and webhooks for deliveries from other services.
Your workspace's allowance is only spent by people in it, so nobody outside can use it up.
For scripts
Calls over a limit answer 429 Too Many Requests with a Retry-After header giving the seconds to wait, and a JSON body:
{ "error": "rate_limited", "message": "This API key is making calls faster than its limit. Try again in 3 seconds.", "retry_after": 3, "policy": "api.key", "limit": 600 }
Wait that many seconds before trying again.