diff --git a/ironicclient/osc/v1/baremetal_node.py b/ironicclient/osc/v1/baremetal_node.py
index e940731e2..c44aefd07 100755
--- a/ironicclient/osc/v1/baremetal_node.py
+++ b/ironicclient/osc/v1/baremetal_node.py
@@ -33,8 +33,10 @@ CONFIG_DRIVE_ARG_HELP = _(
     "the path to the configuration drive file OR the path to a "
     "directory containing the config drive files OR a JSON object to build "
     "config drive from. In case it's a directory, a config drive will be "
-    "generated from it. In case it's a JSON object, a config drive will "
-    "be generated on the server side.")
+    "generated from it. In case it's a JSON object with optional keys "
+    "`meta_data`, `user_data` and `network_data`, a config drive will "
+    "be generated on the server side (see the bare metal API reference for "
+    "more details).")
 
 
 SUPPORTED_INTERFACES = ['bios', 'boot', 'console', 'deploy', 'inspect',
diff --git a/releasenotes/notes/configdrive-7bd2b67830691b2e.yaml b/releasenotes/notes/configdrive-7bd2b67830691b2e.yaml
index b7dbed34f..3ef0ea076 100644
--- a/releasenotes/notes/configdrive-7bd2b67830691b2e.yaml
+++ b/releasenotes/notes/configdrive-7bd2b67830691b2e.yaml
@@ -2,4 +2,8 @@
 features:
   - |
     Supports passing a JSON object to ``--config-drive`` to build the config
-    drive on the server side (requires API version 1.56).
+    drive on the server side (requires API version 1.56) to the following
+    commands:
+
+        openstack baremetal node deploy <node> --config-drive '{...}'
+        openstack baremetal node rebuild <node> --config-drive '{...}'