HTTP

HTTP 201 Created vs 207 Multi-Status

Both HTTP 201 (Created) and 207 (Multi-Status) belong to the 2xx Success category. 201 indicates that the request succeeded and a new resource was created. Typically returned after POST or PUT requests that create a new entity. Meanwhile, 207 means that the response body contains status information for multiple resources, in situations where multiple status codes might be appropriate (WebDAV).

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 response body contains status information for multiple resources, in situations where multiple status codes might be appropriate (WebDAV).

When You See It

In WebDAV operations that affect multiple resources simultaneously.

How to Fix

Parse the XML body to check the status of each individual resource.

Key Differences

1.

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

2.

HTTP 207: The response body contains status information for multiple resources, in situations where multiple status codes might be appropriate (WebDAV).

3.

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

4.

You encounter 207 when in WebDAV operations that affect multiple resources simultaneously.

When to Use Which

For 201 (Created): No fix needed. Check the Location header for the URL of the new resource. For 207 (Multi-Status): Parse the XML body to check the status of each individual resource.

Learn More