diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 06b4cbac82..1e34523892 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -1534,25 +1534,6 @@ Examples:
 
 <- { "return": {} }
 
-query-memory-devices
---------------------
-
-Return a list of memory devices.
-
-Example:
--> { "execute": "query-memory-devices" }
-<- { "return": [ { "data":
-                      { "addr": 5368709120,
-                        "hotpluggable": true,
-                        "hotplugged": true,
-                        "id": "d1",
-                        "memdev": "/objects/memX",
-                        "node": 0,
-                        "size": 1073741824,
-                        "slot": 0},
-                   "type": "dimm"
-                 } ] }
-
 query-acpi-ospm-status
 ----------------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index 0618de88bb..054e0c57f9 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -5641,6 +5641,22 @@
 # Lists available memory devices and their state
 #
 # Since: 2.1
+#
+# Example:
+#
+# -> { "execute": "query-memory-devices" }
+# <- { "return": [ { "data":
+#                       { "addr": 5368709120,
+#                         "hotpluggable": true,
+#                         "hotplugged": true,
+#                         "id": "d1",
+#                         "memdev": "/objects/memX",
+#                         "node": 0,
+#                         "size": 1073741824,
+#                         "slot": 0},
+#                    "type": "dimm"
+#                  } ] }
+#
 ##
 { 'command': 'query-memory-devices', 'returns': ['MemoryDeviceInfo'] }