diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index 116d2f723c..73fef658f8 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -168,24 +168,6 @@ Example:
 
 Note: CPUs' indexes are obtained with the 'query-cpus' command.
 
-xen-save-devices-state
--------
-
-Save the state of all devices to file. The RAM and the block devices
-of the VM are not saved by this command.
-
-Arguments:
-
-- "filename": the file to save the state of the devices to as binary
-data. See xen-save-devices-state.txt for a description of the binary
-format.
-
-Example:
-
--> { "execute": "xen-save-devices-state",
-     "arguments": { "filename": "/tmp/save" } }
-<- { "return": {} }
-
 xen-load-devices-state
 ----------------------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index f021cd0dfc..be653e8b54 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -3039,6 +3039,13 @@
 # Returns: Nothing on success
 #
 # Since: 1.1
+#
+# Example:
+#
+# -> { "execute": "xen-save-devices-state",
+#      "arguments": { "filename": "/tmp/save" } }
+# <- { "return": {} }
+#
 ##
 { 'command': 'xen-save-devices-state', 'data': {'filename': 'str'} }