diff --git a/doc/lua-api/index.rst b/doc/lua-api/index.rst
index b50551c..3aeb8d1 100644
--- a/doc/lua-api/index.rst
+++ b/doc/lua-api/index.rst
@@ -2642,6 +2642,18 @@
 
   :returns: integer
 
+.. js:function:: act:wake_time(milliseconds)
+
+  **context**: action
+
+  Set the script pause timeout to the specified time, defined in
+  milliseconds.
+
+  :param integer milliseconds: the required milliseconds.
+
+  This function may be used when a lua action returns `act.YIELD`, to force its
+  wake-up at most after the specified number of milliseconds.
+
 External Lua libraries
 ======================