HTTP

HTTP 201 Created vs 426 Upgrade Required

HTTP 201 (Created) is a 2xx Success response, while 426 (Upgrade Required) is a 4xx Client Error response. 201 indicates that the request succeeded and a new resource was created. Typically returned after POST or PUT requests that create a new entity. In contrast, 426 means that the server refuses to perform the request using the current protocol but might after the client upgrades to a different protocol.

Description

The request succeeded and a new resource was created. Typically returned after POST or PUT requests that create a new entity.

When You See It

After successfully creating a new user, post, order, or other resource via a REST API.

How to Fix

No fix needed. Check the Location header for the URL of the new resource.

Description

The server refuses to perform the request using the current protocol but might after the client upgrades to a different protocol.

When You See It

When a server requires HTTPS or a newer protocol version.

How to Fix

Switch to the protocol specified in the Upgrade response header.

Key Differences

1.

201 is a 2xx Success response, while 426 is a 4xx Client Error response.

2.

HTTP 201: The request succeeded and a new resource was created. Typically returned after POST or PUT requests that create a new entity.

3.

HTTP 426: The server refuses to perform the request using the current protocol but might after the client upgrades to a different protocol.

4.

You encounter 201 when after successfully creating a new user, post, order, or other resource via a REST API.

5.

You encounter 426 when when a server requires HTTPS or a newer protocol version.

When to Use Which

For 201 (Created): No fix needed. Check the Location header for the URL of the new resource. For 426 (Upgrade Required): Switch to the protocol specified in the Upgrade response header.

Learn More