diff --git a/api-ref/source/baremetal-api-v1-misc.inc b/api-ref/source/baremetal-api-v1-misc.inc
index 078b956fbb..1e9d0c5e87 100644
--- a/api-ref/source/baremetal-api-v1-misc.inc
+++ b/api-ref/source/baremetal-api-v1-misc.inc
@@ -46,8 +46,7 @@ service.
 
 The query string should include either or both a ``node_uuid`` or an
 ``addresses`` query parameter. If a matching Node is found, information about
-that Node shall be returned, including instance-specific information such as
-the configdrive.
+that Node shall be returned.
 
 Normal response codes: 200
 
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index cb8f290d1a..17a3397ef6 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -327,7 +327,8 @@ agent_config:
   type: JSON
 agent_node:
   description: |
-    JSON document containing a subset of Node fields, used by the
+    JSON document containing the Node fields "uuid", "properties",
+    "instance_info", and "driver_internal_info"; used by the
     ironic-python-agent process as it operates on the Node.
   in: body
   required: true