Skip to content

Commit e030139

Browse files
Moves 4xx to separate pages (#22542)
1 parent e817998 commit e030139

23 files changed

+536
-591
lines changed

src/content/docs/support/troubleshooting/http-status-codes/4xx-client-error.mdx

Lines changed: 0 additions & 353 deletions
This file was deleted.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 400
4+
source: null
5+
---
6+
7+
## 400 Bad Request
8+
9+
This error indicates that the client sent a request to the server that could not be understood or processed due to issues with the request itself.
10+
11+
For more information, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
A `400 Bad Request` error occurs due to client-side issues, such as malformed request syntax, invalid request content, message framing problems, or deceptive request routing. For example, if the request contains a special character that is not properly [URL Encoded (or percent-encoded)](https://en.wikipedia.org/wiki/Percent-encoding), an `HTTP Error 400` will be returned.
16+
17+
### Cloudflare-specific information
18+
19+
If you encounter an HTTP error while using the [Cloudflare API](/api/), make sure that you are using the correct syntax, parameters, and body for your API call.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 401
4+
source: null
5+
---
6+
7+
## 401 Unauthorized
8+
9+
This error indicates that the request was not sent with the proper authentication credentials. The server requires authentication to process the request.
10+
11+
For more details, refer to [RFC 7235](https://tools.ietf.org/html/rfc7235).
12+
13+
### Common use cases
14+
15+
A `401 Unauthorized` error occurs when the client fails to provide valid authentication credentials. The server responds with at least one challenge in the form of a `WWW-Authenticate` header field, as outlined in [section 4.1](https://datatracker.ietf.org/doc/html/rfc7235#section-4.1).
16+
17+
If the client resends the request with the same credentials and the challenge remains unchanged, the server may return an entity to assist the client in identifying the correct credentials needed.
18+
19+
### Cloudflare-specific information
20+
21+
When encountering a `401` error while using the Cloudflare API, ensure that you are providing the correct authentication credentials (for example, [API tokens](/fundamentals/api/get-started/create-token/) or [keys](/fundamentals/api/get-started/ca-keys/)). Double-check that the credentials are active and properly formatted. If the error persists, refer to the `WWW-Authenticate` header in the response for guidance on resolving the issue.
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 403
4+
source: null
5+
---
6+
7+
## 403 Forbidden
8+
9+
The `403 Forbidden` status code indicates that the client's request was understood by the server but cannot be fulfilled due to insufficient permissions to access the requested resource.
10+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
11+
12+
### Common use cases
13+
14+
If you encounter a `403` error without the Cloudflare branding, this means that the error is being returned directly by the origin web server, not Cloudflare. This is typically related to permission rules set on your server. Common reasons for this error are:
15+
16+
- Permission rules configured on the origin web server (for example, in an Apache `.htaccess` file).
17+
- Mod_security rules.
18+
- IP deny rules, such as blocking traffic from certain IP ranges. Make sure that [Cloudflare's IP ranges](https://www.cloudflare.com/ips) are not being blocked.
19+
20+
### Cloudflare-specific information
21+
22+
Cloudflare may serve `403` responses in the following scenarios:
23+
24+
- **WAF rules**: The request violated a default WAF managed rule (enabled for all orange-clouded Cloudflare domains) or a custom WAF managed rule specific to your zone. For more information, refer to [WAF Managed Rules](/waf/managed-rules/).
25+
26+
- **Security features**: A `403` response with Cloudflare branding in the response body may be triggered by:
27+
- [WAF Custom or Managed Rules](/waf/) with the challenge or block action.
28+
- [Security Level](/waf/tools/security-level/) settings, which default to Medium.
29+
- [DDoS Protection](/ddos-protection/), which is enabled by default on zones onboarded to Cloudflare, IP applications onboarded to Spectrum, and IP Prefixes onboarded to Magic Transit.
30+
- Most [1xxx Cloudflare error codes](/support/troubleshooting/http-status-codes/cloudflare-1xxx-errors/).
31+
- The [Browser Integrity Check](/waf/tools/browser-integrity-check/).
32+
- [Validation Checks](/waf/tools/validation-checks/).
33+
34+
Cloudflare may also serve an unstyled `403` error page in specific cases. These errors are not logged because they occur early in Cloudflare's infrastructure, before domain configuration is loaded. An example is:
35+
36+
- [SNI](https://www.cloudflare.com/learning/ssl/what-is-sni/): A `403` error is returned when the client sends a host that does not match the SNI (Server Name Indication).
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 404
4+
source: null
5+
---
6+
7+
## 404 Not Found
8+
9+
The `404 Not Found` status code indicates that the origin server was unable to locate the requested resource. Typically, this means the host server could not find the resource. For a more permanent version of this error, the 410 Gone status code should be used.
10+
11+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
These errors typically occur when someone mistypes a URL on your site, when there is a broken link from another page, when a page that previously existed is moved or removed, or there is an error when a search engine indexes your site.
16+
17+
These errors typically account for approximately 3% of total page views for a typical site. However, they often go untracked by traditional analytics platforms, such as Google Analytics. To improve user experience, website owners usually implement a custom 404 page to be displayed when this error is generated.
18+
19+
### Cloudflare-specific information
20+
21+
Cloudflare does not generate `404s` for customer websites, we only proxy the request from the origin server. If you encounter a `404` error on a Cloudflare-powered site, the issue lies with the origin server. In such cases, contact your hosting provider for assistance.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 405
4+
source: null
5+
---
6+
7+
## 405 Method Not Allowed
8+
9+
The 405 Method Not Allowed status code indicates that the origin server recognizes the requested resource but does not support the HTTP method used in the request.
10+
11+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
This error typically occurs when the client uses an unsupported HTTP method to interact with a specific resource. The origin server must include an `Allow` header in the response, which lists the HTTP methods supported for that resource.
16+
17+
For example, attempting a `POST` request on a resource that is unchangeable and only supports `GET` requests will result in a `405` error.
18+
19+
### Cloudflare-specific information
20+
21+
Cloudflare does not directly generate `405` errors. These errors are returned by the origin server when it does not allow the HTTP method used in the request. If you encounter a `405` error, review the configuration of your origin server to ensure the correct methods are enabled for the resource in question.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 406
4+
source: null
5+
---
6+
7+
## 406 Not Acceptable
8+
9+
The `406 Not Acceptable` status code indicates that the requested resource is not available in a format that adheres to the content negotiation headers specified by the client (for example, `Accept-Charset` or `Accept-Language`).
10+
11+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
For example, if a client requests content in a specific language or character set that the server does not support, this error will be generated. To avoid returning a `406` error, the server can instead serve the less preferred method to the client's User-Agent, rather than rejecting the request.
16+
17+
### Cloudflare-specific information
18+
19+
Cloudflare does not generate `406` errors directly but can proxy these responses from the origin server. If content negotiation issues occur, they are typically related to configurations at the origin server, such as language or character set settings.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 407
4+
source: null
5+
---
6+
7+
## 407 Authentication Required
8+
9+
The `407 Proxy Authentication Required` status code indicates that the client did not provide the necessary authentication credentials to access the requested resource through a proxy server.
10+
For more details, refer to [RFC 7235](https://tools.ietf.org/html/rfc7235).
11+
12+
### Common use cases
13+
14+
This error typically occurs in environments where a proxy server is used as an intermediary between the client and the target server. To resolve this, the client must include the appropriate `Proxy-Authorization` header in the request with valid credentials.
15+
16+
### Cloudflare-specific information
17+
18+
Cloudflare does not generate `407` errors but proxies them from the origin server or an upstream proxy. If a `407` error occurs on a Cloudflare-powered site, review the origin server's proxy configuration to ensure authentication requirements are properly set, and verify that the client is providing the required credentials.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 408
4+
source: null
5+
---
6+
7+
## 408 Request Timeout
8+
9+
The `408 Request Timeout` status code indicates that the origin server did not receive the complete request within a reasonable time frame and does not wish to continue waiting for the connection. This response is not commonly used, as servers often prefer to use the "close" connection option to terminate idle connections
10+
11+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
This error typically occurs when a client fails to send a complete request within the server's timeout period. Common scenarios include slow network connections, server overload or client-side delays to complete the request.
16+
17+
### Cloudflare-specific information
18+
19+
Cloudflare does not generate `408` errors but may proxy them from the origin server. If a `408` error occurs on a Cloudflare-powered site, it is essential to review the origin server's timeout settings and ensure that the server is not overloaded. Additionally, verify that the client's Internet connection is stable and that the request is being sent promptly.
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
pcx_content_type: troubleshooting
3+
title: Error 409
4+
source: null
5+
---
6+
7+
## 409 Conflict
8+
9+
The `409 Conflict` status code indicates that the request could not be completed due to a conflict with the current state of the target resource.
10+
11+
For more details, refer to [RFC 7231](https://tools.ietf.org/html/rfc7231).
12+
13+
### Common use cases
14+
15+
This error typically happens with a `PUT` request when multiple clients are attempting to edit the same resource. To solve this issue:
16+
17+
- The server should generate a payload that includes enough information for the client to recognize the source of the conflict.
18+
- Clients should retry the request again after resolving the conflict.
19+
20+
### Cloudflare-specific information
21+
22+
Cloudflare will return a 409 response for a [Error 1001: DNS Resolution Error](/support/troubleshooting/http-status-codes/cloudflare-1xxx-errors/error-1001/).

0 commit comments

Comments
 (0)