From 38dd35af309b798af8af89e90fc80f4a9ce8e49e Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 10:21:10 -0400 Subject: [PATCH 1/7] Create 2025-09-03-rate-limiting-improvement.mdx Rate Limiting Improvement Changelog --- .../2025-09-03-rate-limiting-improvement.mdx | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx new file mode 100644 index 00000000000000..f4c1b91a9c7678 --- /dev/null +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -0,0 +1,29 @@ +--- +title: Introducing new headers to Rate Limiting for Core APIs at Cloudflare +description: New headers and a backoff introduced for SDKs for Rate Limiting for Core APIs +products: + - fundamentals +date: 2025-09-03 +--- +With the increased demand on Core APIs at Cloudflare, we recognize that reaching a rate limit without warning and being forced to wait for the time out can be frustrating. To ensure greater predictability when calling Cloudflare's Core APIs, we have introduced standardized headers to help you understand when you are approaching a rate limit, how many more calls are left until the rate limit is reached, as well as how long you will need to wait until more capacity is available. + +Our SDKs will also be working with these new headers, responding with a back off when rate limits are being approached. There is nothing that needs to be enable on your end - these back offs will happen on their own. + +As always, if you need any help with rate limits, please contact Support. + +### Changes +#### New Headers + +**Headers that are always returned:** +- X-RateLimit-Limit: Total Number of requests the caller can make +- X-RateLimit-Remaining: Number of requests before Rate Limit kicks in + +**Returned only when a rate limit has been reached (error code: 429):** +- Retry-After: Number of Seconds until more capacity is available, rounded up +- X-RateLimit-Reset: RFC 1123 Formatted Date as to when more capacity is available + +#### SDK Back offs +- All SDKs will automatically respond to the headers, instituting a backoff when limits are approached. + +### GraphQL and Edge APIs +These new headers and back offs are only in effect for Cloudflare Core APIs, and will not effect GraphQL or Edge APIs. From 9e6b3a169b99b14c4690025d1be4cf75ca986c52 Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 11:20:39 -0400 Subject: [PATCH 2/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx Co-authored-by: Justin Hutchings --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index f4c1b91a9c7678..e011ad63661a61 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -1,5 +1,5 @@ --- -title: Introducing new headers to Rate Limiting for Core APIs at Cloudflare +title: Introducing new headers for rate limiting on Cloudflare's API description: New headers and a backoff introduced for SDKs for Rate Limiting for Core APIs products: - fundamentals From 6e65a8cceb297a7c2d697cbc1178abe28ac1308a Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 11:20:56 -0400 Subject: [PATCH 3/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx Co-authored-by: Justin Hutchings --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index e011ad63661a61..5bb6a4f27a116b 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -1,6 +1,6 @@ --- title: Introducing new headers for rate limiting on Cloudflare's API -description: New headers and a backoff introduced for SDKs for Rate Limiting for Core APIs +description: Cloudflare's API handles rate limiting automatically in the SDKs and how you can respond appropriately in your code. products: - fundamentals date: 2025-09-03 From b05b29121ce927036c4e99f1a94fb59d5effba53 Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 11:30:45 -0400 Subject: [PATCH 4/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx Co-authored-by: Justin Hutchings --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index 5bb6a4f27a116b..355526473c9596 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -5,7 +5,7 @@ products: - fundamentals date: 2025-09-03 --- -With the increased demand on Core APIs at Cloudflare, we recognize that reaching a rate limit without warning and being forced to wait for the time out can be frustrating. To ensure greater predictability when calling Cloudflare's Core APIs, we have introduced standardized headers to help you understand when you are approaching a rate limit, how many more calls are left until the rate limit is reached, as well as how long you will need to wait until more capacity is available. +Cloudflare's API now supports rate limiting headers using the pattern developed by the [IETF draft on rate limiting](https://ietf-wg-httpapi.github.io/ratelimit-headers/draft-ietf-httpapi-ratelimit-headers.html). This allows API consumers to know how many more calls are left until the rate limit is reached, as well as how long you will need to wait until more capacity is available. Our SDKs will also be working with these new headers, responding with a back off when rate limits are being approached. There is nothing that needs to be enable on your end - these back offs will happen on their own. From ae500b928f88be77305a59ddbc138d3f11a90647 Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 11:30:54 -0400 Subject: [PATCH 5/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx Co-authored-by: Justin Hutchings --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index 355526473c9596..4fa65168d7f6aa 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -7,7 +7,7 @@ date: 2025-09-03 --- Cloudflare's API now supports rate limiting headers using the pattern developed by the [IETF draft on rate limiting](https://ietf-wg-httpapi.github.io/ratelimit-headers/draft-ietf-httpapi-ratelimit-headers.html). This allows API consumers to know how many more calls are left until the rate limit is reached, as well as how long you will need to wait until more capacity is available. -Our SDKs will also be working with these new headers, responding with a back off when rate limits are being approached. There is nothing that needs to be enable on your end - these back offs will happen on their own. +Our SDKs automatically work with these new headers, backing off when rate limits are approached. There is no action required for users of the latest Cloudflare SDKs to take advantage of this. As always, if you need any help with rate limits, please contact Support. From b0302de8830ef9368b3d7e2ad3a4e23cc1c663c6 Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 11:31:04 -0400 Subject: [PATCH 6/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx Co-authored-by: Justin Hutchings --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index 4fa65168d7f6aa..b1f665b867419d 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -26,4 +26,7 @@ As always, if you need any help with rate limits, please contact Support. - All SDKs will automatically respond to the headers, instituting a backoff when limits are approached. ### GraphQL and Edge APIs -These new headers and back offs are only in effect for Cloudflare Core APIs, and will not effect GraphQL or Edge APIs. +These new headers and back offs are only available for Cloudflare REST APIs, and will not affect GraphQL. + +### For more information +* [Rate limits at Cloudflare](https://developers.cloudflare.com/fundamentals/api/reference/limits/) From 9f7b0fd02fbce0fe96c95e435c7dc77ba9b935f7 Mon Sep 17 00:00:00 2001 From: Katie D'Angelo Date: Wed, 3 Sep 2025 22:10:25 -0400 Subject: [PATCH 7/7] Update src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Denise Peña <75506267+dcpena@users.noreply.github.com> --- .../fundamentals/2025-09-03-rate-limiting-improvement.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx index b1f665b867419d..54b445e356b5cc 100644 --- a/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx +++ b/src/content/changelog/fundamentals/2025-09-03-rate-limiting-improvement.mdx @@ -1,6 +1,6 @@ --- title: Introducing new headers for rate limiting on Cloudflare's API -description: Cloudflare's API handles rate limiting automatically in the SDKs and how you can respond appropriately in your code. +description: Cloudflare's API handles rate limiting automatically in the SDKs and how to respond appropriately in your code. products: - fundamentals date: 2025-09-03