diff --git a/doc/api/sqlite.md b/doc/api/sqlite.md
index 40ec877ddde3..adddeb03d566 100644
--- a/doc/api/sqlite.md
+++ b/doc/api/sqlite.md
@@ -295,7 +295,10 @@ added: v22.5.0
 -->
 
 Closes the database connection. An exception is thrown if the database is not
-open. This method is a wrapper around [`sqlite3_close_v2()`][].
+open. An \[`ERR_INVALID_STATE`]\[] error is thrown if the method is called while
+a statement is executing, such as inside a user-defined function, an aggregate
+function, or an authorizer callback. This method is a wrapper around
+[`sqlite3_close_v2()`][].
 
 ### `database.loadExtension(path[, entryPoint])`