diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 817cc5a721..f51ffbf442 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -1607,34 +1607,6 @@ Example:
 
 Note: This example has been shortened as the real response is too long.
 
-query-events
---------------
-
-List QMP available events.
-
-Each event is represented by a json-object, the returned value is a json-array
-of all events.
-
-Each json-object contains:
-
-- "name": event's name (json-string)
-
-Example:
-
--> { "execute": "query-events" }
-<- {
-      "return":[
-         {
-            "name":"SHUTDOWN"
-         },
-         {
-            "name":"RESET"
-         }
-      ]
-   }
-
-Note: This example has been shortened as the real response is too long.
-
 query-qmp-schema
 ----------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index dfd3299774..b621528f85 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -479,6 +479,23 @@
 # Returns: A list of @EventInfo for all supported events
 #
 # Since: 1.2.0
+#
+# Example:
+#
+# -> { "execute": "query-events" }
+# <- {
+#      "return": [
+#          {
+#             "name":"SHUTDOWN"
+#          },
+#          {
+#             "name":"RESET"
+#          }
+#       ]
+#    }
+#
+# Note: This example has been shortened as the real response is too long.
+#
 ##
 { 'command': 'query-events', 'returns': ['EventInfo'] }