diff --git a/docs/qmp-commands.txt b/docs/qmp-commands.txt
index ba4fd1ccda..6038f5cc73 100644
--- a/docs/qmp-commands.txt
+++ b/docs/qmp-commands.txt
@@ -1088,21 +1088,6 @@ Example:
 -> { "execute": "balloon", "arguments": { "value": 536870912 } }
 <- { "return": {} }
 
-set_link
---------
-
-Change the link status of a network adapter.
-
-Arguments:
-
-- "name": network device name (json-string)
-- "up": status is up (json-bool)
-
-Example:
-
--> { "execute": "set_link", "arguments": { "name": "e1000.0", "up": false } }
-<- { "return": {} }
-
 getfd
 -----
 
diff --git a/qapi-schema.json b/qapi-schema.json
index 1675a9bf16..43b485e145 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -2352,6 +2352,13 @@
 # Notes: Not all network adapters support setting link status.  This command
 #        will succeed even if the network adapter does not support link status
 #        notification.
+#
+# Example:
+#
+# -> { "execute": "set_link",
+#      "arguments": { "name": "e1000.0", "up": false } }
+# <- { "return": {} }
+#
 ##
 { 'command': 'set_link', 'data': {'name': 'str', 'up': 'bool'} }