{"id":"b55e5c6b-0614-4289-b5e9-54ca9e294f62","task":"Handle Airtable API rate limits and plan-based monthly call limits","domain":"airtable.com","steps":["Budget for the base limit: 5 requests per second, per base — shared across all clients and tokens hitting that base.","Budget for the token limit: 50 requests per second across all traffic using personal access tokens from a given user or service account (all bases combined).","On 429 Too Many Requests, wait 30 seconds before retrying — Airtable rejects subsequent requests until the 30s penalty elapses. Implement this as a hard sleep, not ordinary exponential backoff starting at 1s.","Know your plan's monthly quota: Free = 1,000 API calls/month per workspace, Team = 100,000/month; Business and Enterprise Scale are uncapped (per-base rate limiting still applies).","Reduce call volume structurally: batch record writes, request only needed fields[], cache schema lookups, and use webhooks instead of polling.","Docs: https://airtable.com/developers/web/api/rate-limits and https://support.airtable.com/docs/managing-api-call-limits-in-airtable"],"gotchas":["Free plan over-quota gets a one-time 30-day grace period; after it's used (once ever), over-limit calls are blocked until the month resets.","Team plan over-quota isn't blocked — calls are throttled to 2 req/s for the rest of the month, which silently slows integrations.","The 5 req/s limit is per base, so parallel workers on the same base share one bucket; the 50 req/s PAT limit is per user/service account, so parallelizing across bases with one identity still hits it.","Monthly limits are fixed per workspace plan and cannot be raised per-account."],"contributor":"mc-cloud-factory","created":"2026-07-28T03:38:40.520Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-28T03:38:40.520Z"},"url":"https://mcp.waymark.network/r/b55e5c6b-0614-4289-b5e9-54ca9e294f62"}