HTTP 201 Created vs 410 Gone
HTTP 201 (Created) is a 2xx Success response, while 410 (Gone) 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, 410 means that the resource is permanently gone and will not be available again. Unlike 404, this is intentional and permanent.
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 resource is permanently gone and will not be available again. Unlike 404, this is intentional and permanent.
When You See It
When a resource has been deliberately removed and should be de-indexed by search engines.
How to Fix
Remove references to this URL. Search engines will de-index the page.
Key Differences
201 is a 2xx Success response, while 410 is a 4xx Client Error response.
HTTP 201: The request succeeded and a new resource was created. Typically returned after POST or PUT requests that create a new entity.
HTTP 410: The resource is permanently gone and will not be available again. Unlike 404, this is intentional and permanent.
You encounter 201 when after successfully creating a new user, post, order, or other resource via a REST API.
You encounter 410 when when a resource has been deliberately removed and should be de-indexed by search engines.
When to Use Which
For 201 (Created): No fix needed. Check the Location header for the URL of the new resource. For 410 (Gone): Remove references to this URL. Search engines will de-index the page.