diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 93b3742ac5..715b9231fd 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -94,16 +94,6 @@ Example:
 
 Note: CPUs' indexes are obtained with the 'query-cpus' command.
 
-x-colo-lost-heartbeat
---------------------
-
-Tell COLO that heartbeat is lost, a failover or takeover is needed.
-
-Example:
-
--> { "execute": "x-colo-lost-heartbeat" }
-<- { "return": {} }
-
 qmp_capabilities
 ----------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index 7aeb0fa1e7..661f82b033 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -1157,6 +1157,12 @@
 # then takes over server operation to become the service VM.
 #
 # Since: 2.8
+#
+# Example:
+#
+# -> { "execute": "x-colo-lost-heartbeat" }
+# <- { "return": {} }
+#
 ##
 { 'command': 'x-colo-lost-heartbeat' }