diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index e0d827a35d..e7d47d3be0 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -1945,36 +1945,6 @@ Example:
       ]
    }
 
-query-iothreads
----------------
-
-Returns a list of information about each iothread.
-
-Note this list excludes the QEMU main loop thread, which is not declared
-using the -object iothread command-line option.  It is always the main thread
-of the process.
-
-Return a json-array. Each iothread is represented by a json-object, which contains:
-
-- "id": name of iothread (json-str)
-- "thread-id": ID of the underlying host thread (json-int)
-
-Example:
-
--> { "execute": "query-iothreads" }
-<- {
-      "return":[
-         {
-            "id":"iothread0",
-            "thread-id":3134
-         },
-         {
-            "id":"iothread1",
-            "thread-id":3135
-         }
-      ]
-   }
-
 query-pci
 ---------
 
diff --git a/qapi-schema.json b/qapi-schema.json
index bf1788d5f9..2e5375da1b 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -1386,6 +1386,22 @@
 # Returns: a list of @IOThreadInfo for each iothread
 #
 # Since: 2.0
+#
+# Example:
+#
+# -> { "execute": "query-iothreads" }
+# <- { "return": [
+#          {
+#             "id":"iothread0",
+#             "thread-id":3134
+#          },
+#          {
+#             "id":"iothread1",
+#             "thread-id":3135
+#          }
+#       ]
+#    }
+#
 ##
 { 'command': 'query-iothreads', 'returns': ['IOThreadInfo'] }