diff --git a/doc/api/fs.md b/doc/api/fs.md
index 3b3c6efd58243f..b944f827c1b735 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -2898,7 +2898,8 @@ changes:
 
 Asynchronously rename file at `oldPath` to the pathname provided
 as `newPath`. In the case that `newPath` already exists, it will
-be overwritten. No arguments other than a possible exception are
+be overwritten. If there is a directory at `newPath`, an error will
+be raised instead. No arguments other than a possible exception are
 given to the completion callback.
 
 See also: rename(2).