diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 9e26cfe970..397b3d6397 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -205,23 +205,6 @@ Example:
 <- { "return": { "status": "active", "completed": 1024000,
                  "total": 2048000 } }
 
-object-add
-----------
-
-Create QOM object.
-
-Arguments:
-
-- "qom-type": the object's QOM type, i.e. the class name (json-string)
-- "id": the object's ID, must be unique (json-string)
-- "props": a dictionary of object property values (optional, json-dict)
-
-Example:
-
--> { "execute": "object-add", "arguments": { "qom-type": "rng-random", "id": "rng1",
-     "props": { "filename": "/dev/hwrng" } } }
-<- { "return": {} }
-
 object-del
 ----------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index 4cb639f3fc..2982e3168b 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -3390,6 +3390,14 @@
 #          Error if @qom-type is not a valid class name
 #
 # Since: 2.0
+#
+# Example:
+#
+# -> { "execute": "object-add",
+#      "arguments": { "qom-type": "rng-random", "id": "rng1",
+#                     "props": { "filename": "/dev/hwrng" } } }
+# <- { "return": {} }
+#
 ##
 { 'command': 'object-add',
   'data': {'qom-type': 'str', 'id': 'str', '*props': 'any'} }