Skip to main content
Each key can make 120 requests a minute. Each IP address can also make 600 requests a minute, across all its keys. A request that changes data (POST or PATCH) also counts towards a second limit: 30 changes a minute for each key. It stops a script that has gone wrong from filling your boards with tasks someone has to clear by hand. The headers below always describe the 120-a-minute limit; if you go over the changes limit, the 429 tells you how long to wait. For most groups this is far more than enough. A sheet that reads 1,000 members at 200 a page needs 5 requests.

​
Headers

Every response carries three headers:

​
When you go over

The API answers 429 with the code rate_limited. The response has a Retry-After header, and retryAfter in the body. Both give the number of seconds to wait.
Wait that long, then send the same request again. Do not retry at once in a loop. Every retry counts against the limit.

​
Tips

  • Use limit=200 to read a list in fewer requests.
  • Refresh a spreadsheet once a day or once an hour, not every minute.
  • One key per tool makes it easy to see which tool is busy, and to revoke only that one.