// AI Platform Drift

Rate Limiting binding adds optional delta parameter for weighted requests

Cloudflare developer changelog · published 2026-11-14 18:05 UTC
WORTH KNOWING VERIFY_ONLY APILIMITS
WHAT CHANGEDCloudflare's Rate Limiting binding API now accepts an optional delta parameter in the limit() method. The parameter controls how many units a single call consumes against a rate limit, defaulting to 1. TypeScript support requires @cloudflare/workers-types 5.20261106.1 or later; local development requires Wrangler 4.157.0 or later.
WHY IT MATTERSDifferent operations can now consume different amounts of the same user's rate limit allowance, allowing expensive operations like searches to count as 10 units while cheap lookups count as 1. This changes how rate limit consumption is calculated when the parameter is used.
WHAT TO DOIf you use Cloudflare Workers Rate Limiting binding and want to implement weighted requests, upgrade to Wrangler 4.157.0+ for local development and @cloudflare/workers-types 5.20261106.1+ for TypeScript support, then add the delta parameter to limit() calls where operations have different costs.
Model-reported confidence 85% (not measured accuracy) Primary source ↗ written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## Workers - Count weighted requests with the Rate Limiting binding API in Workers
+https://developers.cloudflare.com/changelog/post/2026-11-04-rate-limit-weighted-requests/
+Wed, 04 Nov 2026 00:00:00 GMT
+
+Requests can require different amounts of work. A product lookup might be cheap, while a search runs an expensive database query. Use weighted requests to make expensive operations consume more of the same rate limit.
+The Rate Limiting binding now accepts an optional delta in limit(). Pass delta to choose how many units a call consumes.
+For example, assign one unit to a product lookup and 10 units to an expensive search. Both operations consume the same user's allowance. The following handler takes a verified user ID from your application's authentication flow:
+src/index.jsjsexport async function handleAuthenticatedRequest(request, env, userId) {
+const { pathname } = new URL(request.url);
+
+// Assign searches a weight of 10 and other requests a weight of 1.
+const delta = pathname === "/search" ? 10 : 1;
+
+const { success } = await env.MY_RATE_LIMITER.limit({
+key: userId,
+delta,
+});
+if (!success) {
+return new Response("Rate limit exceeded", { status: 429 });
+}
+
+return new Response("Success!");
+}src/index.tstsexport async function handleAuthenticatedRequest(
+request: Request,
+env: Env,
+userId: string,
+): Promise<Response> {
+const { pathname } = new URL(request.url);
+
+// Assign searches a weight of 10 and other requests a weight of 1.
+const delta = pathname === "/search" ? 10 : 1;
+
+const { success } = await env.MY_RATE_LIMITER.limit({
+key: userId,
+delta,
+});
+if (!success) {
+return new Response("Rate limit exceeded", { status: 429 });
+}
+
+return new Response("Success!");
+}
+The delta defaults to 1. To use delta in local development, use Wrangler 4.157.0 ↗︎ or later. For TypeScript support, use @cloudflare/workers-types version 5.20261106.1 or later.
+For more details, refer to Weighted requests.
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
triage verdictMATERIAL at 0.92, needed 0.5
triage reasoningNew weighted request feature in Rate Limiting binding API with version requirements affects how developers implement rate limiting.
signalsnew API capability added to Rate Limiting binding · optional delta parameter introduced to limit() method · changes how rate limit consumption is calculated · minimum version requirements specified (Wrangler 4.157.0, @cloudflare/workers-types 5.20261106.1) · affects rate limit behavior and cost accounting for developers
suppression—
triage modelanthropic/claude-haiku-4.5 ($0.00000)
writer modelanthropic/claude-sonnet-4.5 ($0.00000)