diff --git a/doc/rapi.rst b/doc/rapi.rst
index b01d21785aa453ac9d2ce763dcb84c0d07889978..2299cb7ef04c6ea843237d9845b8faae2e136f1a 100644
--- a/doc/rapi.rst
+++ b/doc/rapi.rst
@@ -1004,10 +1004,15 @@ It supports the following commands: ``POST``.
 ``POST``
 ~~~~~~~~
 
-No parameters are required, but the bool parameter ``live`` can be set
-to use live migration (if available).
+If no mode is explicitly specified, each instances' hypervisor default
+migration mode will be used. Query parameters:
+
+``live`` (bool)
+  If set, use live migration if available.
+``mode`` (string)
+  Sets migration mode, ``live`` for live migration and ``non-live`` for
+  non-live migration. Supported by Ganeti 2.2 and above.
 
-    migrate?live=[0|1]
 
 ``/2/nodes/[node_name]/role``
 +++++++++++++++++++++++++++++