diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 094e314ce6..da7e88b332 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -2458,27 +2458,6 @@ Example:
      ]
    }
 
-migrate-set-capabilities
-------------------------
-
-Enable/Disable migration capabilities
-
-- "xbzrle": XBZRLE support
-- "rdma-pin-all": pin all pages when using RDMA during migration
-- "auto-converge": throttle down guest to help convergence of migration
-- "zero-blocks": compress zero blocks during block migration
-- "compress": use multiple compression threads to accelerate live migration
-- "events": generate events for each migration state change
-- "postcopy-ram": postcopy mode for live migration
-- "x-colo": COarse-Grain LOck Stepping (COLO) for Non-stop Service
-
-Arguments:
-
-Example:
-
--> { "execute": "migrate-set-capabilities" , "arguments":
-     { "capabilities": [ { "capability": "xbzrle", "state": true } ] } }
-
 query-migrate-capabilities
 --------------------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index 6ea311c8a3..34712f223e 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -846,6 +846,12 @@
 # @capabilities: json array of capability modifications to make
 #
 # Since: 1.2
+#
+# Example:
+#
+# -> { "execute": "migrate-set-capabilities" , "arguments":
+#      { "capabilities": [ { "capability": "xbzrle", "state": true } ] } }
+#
 ##
 { 'command': 'migrate-set-capabilities',
   'data': { 'capabilities': ['MigrationCapabilityStatus'] } }