207

Multi-Status

2xx Success

Back to list

Server perspective

Use 207 mainly in WebDAV when one request needs to report separate statuses for multiple resources or properties.

When to use

  • Return 207 for PROPFIND, PROPPATCH, or other WebDAV operations with mixed per-item outcomes
  • Use it when one top-level status code would lose too much detail

How to respond

  • Return a DAV:multistatus XML body with per-resource or per-property results
  • Be explicit about which resource each embedded status applies to

Headers to consider

  • No status-specific header is required; set Content-Type for the DAV multi-status body.

Response body

  • Include an XML multi-status document that enumerates the detailed outcomes

Server-side pitfalls

  • Do not use 207 as a vague batch-success shortcut outside clients that understand the format
  • Do not rely on the top-level 207 alone; the real detail lives in the body

Examples

Mixed WebDAV property updates

Request:PROPPATCH /collection/
Response:207 Multi-Status with separate XML statuses per resource

The server returns the fine-grained result set instead of flattening everything into one code.

References

Related 2xx Success Codes