diff --git a/doc/api/http.md b/doc/api/http.md
index d2c6d3ec98f3e9..58e5b53eaf41d3 100644
--- a/doc/api/http.md
+++ b/doc/api/http.md
@@ -681,7 +681,9 @@ Defaults to `'utf8'`.
 The `callback` argument is optional and will be called when this chunk of data
 is flushed.
 
-Returns `request`.
+Returns `true` if the entire data was flushed successfully to the kernel
+buffer. Returns `false` if all or part of the data was queued in user memory.
+`'drain'` will be emitted when the buffer is free again.
 
 ## Class: http.Server
 <!-- YAML