Insufficient Storage

Overview

507 Insufficient Storage means the server cannot store the representation needed to complete the request. Defined in WebDAV, it is returned when disk space or a quota runs out during an upload or storage operation.

This is a server-side resource limit. It happens when physical disk space is low, a per-user or per-account storage quota is exceeded, or a temporary storage area is full.

When it happens

• Uploading/storing a file while the server is low on disk space
• Exceeding a user's or account's storage quota
• A temp directory or volume is full and the write fails

Request / Response example

PUT /files/backup.zip HTTP/1.1
Host: dav.example.com
Content-Type: application/zip
Content-Length: 524288000

<500 MB body>

HTTP/1.1 507 Insufficient Storage
Content-Type: application/xml

<D:error xmlns:D="DAV:"><D:quota-not-exceeded/></D:error>

In code

app.put('/files/:name', async (req, res) => {
  const free = await getFreeBytes(storageDir);
  if (Number(req.headers['content-length']) > free) {
    return res.status(507).send('Insufficient Storage');
  }
  // stream the upload to disk...
});

Notes

• 507 is a WebDAV extension code, but some storage/backup APIs borrow it to signal being out of space.
• If the body is simply "too big" by policy (over a size limit), 413 Content Too Large fits better; if there is nowhere to store it, 507 is more accurate.

Related status codes

Specification