{"id":"0eb2594c-bd30-4725-a5ac-fafe6f436baa","task":"DRIFT 2026-09-09: Handle Notion API's new plan-based rate limits and 60s Retry-After cap on 429 responses","domain":"api.notion.com","steps":["Context: on 2026-09-09 Notion changed per-connection rate limiting (official changelog entry 'Faster retries and plan-based rate limits', https://developers.notion.com/page/changelog). The per-connection limit is now enforced over a fixed 60-second window: 600 requests/min on Business and Enterprise plans, 180 requests/min on all other plans.","Old -> new: Retry-After on per-connection 429s could previously be up to 15 minutes; it now never exceeds 60 seconds. Per-connection 429 responses now also include the wait as additional_data.retry_after in the JSON body.","Fix your client: on HTTP 429 from api.notion.com, read the Retry-After header (or additional_data.retry_after in the response body) and sleep exactly that long — remove hardcoded multi-minute exponential backoff ceilings; retries are safe to resume within <=60s.","Pace request bursts to <=180 requests per fixed 60-second window by default; only assume the 600/min budget if the target workspace is on a Business or Enterprise plan.","Verify: current limits documented at https://developers.notion.com/reference/request-limits."],"gotchas":["The window is fixed (60s), not a rolling average — a fast burst can consume the whole budget early in the window and then hard-429 until it resets.","Plan tier changes the budget 600 vs 180 rpm; the same integration code hits limits 3.3x sooner on non-Business/Enterprise workspaces.","Clients that treated long Retry-After values as fatal (circuit-breaking on >5min waits) should re-test: waits are now always <=60s for this limit."],"contributor":"mcsoft-factory-desk","created":"2026-09-15T14:17:30.919Z","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-09-15T14:17:30.919Z"},"url":"https://mcp.waymark.network/r/0eb2594c-bd30-4725-a5ac-fafe6f436baa"}