Skip to content

Commit aa0347a

Browse files
committed
Add 405 FAQ and changelog for /cdn-cgi/rum
1 parent b99d632 commit aa0347a

2 files changed

Lines changed: 23 additions & 0 deletions

File tree

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: "/cdn-cgi/rum endpoint now returns 405 for non-POST requests"
3+
description: The /cdn-cgi/rum beacon endpoint now returns 405 Method Not Allowed instead of 404 when called with an unsupported HTTP method.
4+
date: 2026-05-13
5+
products:
6+
- web-analytics
7+
---
8+
9+
The `/cdn-cgi/rum` beacon endpoint now returns `405 Method Not Allowed` for non-POST requests instead of `404 Not Found`. The response includes an `Allow: POST, OPTIONS` header per [RFC 9110 §15.5.6](https://www.rfc-editor.org/rfc/rfc9110#section-15.5.6).
10+
11+
Previously, sending a `GET` or other non-POST request to this endpoint returned a `404`, which was misleading because it suggested the endpoint did not exist. The new `405` response clearly indicates that the endpoint exists but only accepts `POST` requests.
12+
13+
The Web Analytics beacon (`beacon.min.js`) already uses `POST` for all metric submissions, so this change does not affect normal beacon operation. `OPTIONS` requests for CORS preflight continue to work as before.
14+
15+
For more information, refer to the [Web Analytics FAQ](/web-analytics/faq/#why-am-i-getting-a-405-method-not-allowed-error-from-cdn-cgirum).

src/content/docs/web-analytics/faq.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,14 @@ Since only one JS snippet can be rendered and used per page, you cannot have mul
5252

5353
If you have a `Cache-Control` header set to `public, no-transform`, Cloudflare proxy will not be able to modify the original payload of the website. Therefore, the Beacon script will not be automatically injected to your site, and Web Analytics will not work. Refer to [Origin cache control](/cache/concepts/cache-control/) for more information.
5454

55+
### Why am I getting a `405 Method Not Allowed` error from `/cdn-cgi/rum`?
56+
57+
The `/cdn-cgi/rum` endpoint only accepts `POST` requests for data ingestion. If you send a request using any other HTTP method (for example, `GET`, `PUT`, or `DELETE`), the endpoint returns a `405 Method Not Allowed` response with an `Allow: POST, OPTIONS` header.
58+
59+
The Web Analytics beacon (`beacon.min.js`) always uses `POST` when reporting metrics. If you see `405` errors in your logs, the requests are not coming from the beacon itself.
60+
61+
No action is required unless you are making custom requests to this endpoint. If you are, ensure your implementation uses the `POST` method. `OPTIONS` requests (CORS preflight) are also supported and will continue to work normally.
62+
5563
---
5664

5765
## Setup

0 commit comments

Comments
 (0)