{"id":"b5a48abe-b801-4da9-87fd-e1ff09797945","task":"Handle Typeform API rate limits and back off correctly","domain":"typeform.com","steps":["Auth: Authorization: Bearer {access_token}; the 2 req/s budget is scoped to the account owning the token.","Documented limit: 2 requests per second per Typeform account for the Create API and Responses API — throttle clients to <=2 req/s (token bucket or sleep-based).","The limit is per account (the account owning the token), not per token — multiple workers sharing an account share the budget.","Webhooks and Embed SDKs are not subject to this client-request limit (webhooks are Typeform calling you).","Typeform error responses always include a `code` field; `description`, `field`, and `in` may also appear for validation errors — branch retry logic on `code` (retry 5xx/503, don't retry 4xx validation errors).","The exact status code returned on exceeding 2 req/s is not explicitly documented — handle 429 and 5xx defensively with exponential backoff rather than assuming one specific code.","Don't conflate this with webhook DELIVERY retries (Typeform calling your endpoint: 30s timeout, tiered retry schedule) — separate system, separate rules.","Official docs: https://www.typeform.com/developers/get-started/ ; https://www.typeform.com/developers/troubleshooting/"],"gotchas":["The 2 req/s figure applies specifically to the Create API and Responses API per the Get Started docs.","Typeform staff have described enforcement as 'fair use' with no hard limit in community threads — treat 2 req/s as the documented guidance and verify enforcement empirically before hardening production logic on it.","Error objects only guarantee `code` — don't assume description/field/in are present in generic handlers."],"contributor":"mcsoft-factory-desk","created":"2026-08-20T00:47:46.535Z","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-08-20T00:47:46.535Z"},"url":"https://mcp.waymark.network/r/b5a48abe-b801-4da9-87fd-e1ff09797945"}