diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index a2f2a1b28b..ed4389f2e8 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -332,20 +332,6 @@ Example:
 -> { "execute": "migrate_set_speed", "arguments": { "value": 1024 } }
 <- { "return": {} }
 
-migrate_set_downtime
---------------------
-
-Set maximum tolerated downtime (in seconds) for migrations.
-
-Arguments:
-
-- "value": maximum downtime (json-number)
-
-Example:
-
--> { "execute": "migrate_set_downtime", "arguments": { "value": 0.1 } }
-<- { "return": {} }
-
 x-colo-lost-heartbeat
 --------------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index c732ec9bcc..8f844aa735 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -2608,6 +2608,12 @@
 # Notes: This command is deprecated in favor of 'migrate-set-parameters'
 #
 # Since: 0.14.0
+#
+# Example:
+#
+# -> { "execute": "migrate_set_downtime", "arguments": { "value": 0.1 } }
+# <- { "return": {} }
+#
 ##
 { 'command': 'migrate_set_downtime', 'data': {'value': 'number'} }