Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Microsoft Fabric uses throttling to maintain optimal performance and reliability. Fabric limits the number of API calls within a time window per user, so a caller can only make a certain amount of calls in a given period.
Throttling policies take place for both the API caller and the API itself. This means, that Fabric limits the number of calls a specific caller can perform on a specific API.
Throttling message
When throttling occurs, Fabric returns an HTTP status code 429 (Too many requests). Fabric returns a 429 status code for two distinct reasons, each identified by a different errorCode in the response body:
Inspect the errorCode value in the response to determine which condition occurred and how to respond.
Rate limit exceeded (RequestBlocked)
When a user sends many requests that exceed a predetermined limit during a time window, Fabric throttles further requests from that user for a short period.
In this case, Fabric returns an HTTP status code 429 (Too many requests) with a Retry-After HTTP header in the response, indicating how many seconds the calling application should wait before retrying the call. The response body uses the RequestBlocked error code:
{
"errorCode": "RequestBlocked",
"message": "Request is blocked by the upstream service until: 2/18/2026 10:45:04 PM (UTC)"
}
When you receive this error, wait for the duration specified in the Retry-After header before retrying the request.
The following screenshot shows a response example, suggesting that the user waits 55 seconds before retrying the call.
Capacity limit exceeded (CapacityLimitExceeded)
Fabric also returns an HTTP status code 429 (Too many requests) when your organization's Fabric capacity has exceeded its limits. Unlike rate limiting, this throttling isn't caused by the number of API calls a specific caller makes. Instead, it occurs when the compute (capacity units) consumed on your capacity exceeds the limits of the purchased Fabric SKU. The response body uses the CapacityLimitExceeded error code:
{
"errorCode": "CapacityLimitExceeded",
"message": "Your organization's Fabric compute capacity has exceeded its limits. Try again later."
}
When you receive this error, try the request again later. Because this throttling depends on the overall compute consumed on your capacity rather than your individual request rate, retrying immediately is unlikely to succeed until the capacity's compute usage falls back within its limits. If you encounter this error frequently, consider scaling up or scaling out your Fabric capacity. For more information about capacity units, SKUs, and how Fabric capacity is consumed, see Plan your capacity size.
Considerations and limitations
Every Fabric admin and core public API call is throttled.