Skip to main content
Post

Rate limit waits in the response body

Notion's API now puts rate-limit wait times in the response body, so clients that can't read headers, including MCP clients, can see how long to wait.

Any 429 or 529 response with a Retry-After header repeats the wait in additional_data.retry_after. New rate_limit_reason values distinguish an endpoint's own limit, public_api_endpoint_rate_limit, from restricted connection access, public_api_request_blocked. A workspace-limit 429 also now explains that the limit is shared across all of the workspace's connections.

Loading replies…