review_rate_limits
Identify rate limit throttling periods and affected operation groups (e.g., runs, deployments) in Prefect Cloud to diagnose HTTP 429 errors.
Instructions
Review rate limit usage for this Prefect Cloud account (Cloud only).
Prefect Cloud API access is governed by rate limits in different categories (runs, deployments, flows, work_pools, writing-logs, etc.). When you see HTTP 429 errors or "Too Many Requests" responses from the Prefect API, use this tool to identify which operation groups were throttled and when.
Queries all common rate limit operation groups and groups consecutive throttled minutes into periods, showing which operation groups were affected during each stretch.
Note: These are not API authentication keys - they're categories of API operations that are rate limited together (e.g., "runs" includes all flow run API calls, "writing-logs" includes log write operations).
Useful for diagnosing why API calls are being rate limited. The response shows:
Distinct time periods where throttling occurred
Which operation groups were throttled during each period
Total denied requests and peak denials per minute for each group
Examples: - Check recent throttling: review_rate_limits() - Custom time range: review_rate_limits(since="2025-09-30T00:00:00Z", until="2025-10-01T00:00:00Z")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | Start time for usage data (ISO 8601). Defaults to 3 days ago. | |
| until | No | End time for usage data (ISO 8601). Defaults to 1 minute ago. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | Yes | ||
| since | Yes | ||
| until | Yes | ||
| success | Yes | ||
| summary | Yes | ||
| account_id | Yes | ||
| throttling_periods | Yes |