diff --git a/api-ref/source/baremetal-api-v1-misc.inc b/api-ref/source/baremetal-api-v1-misc.inc
index 1e9d0c5e87..e5623ff5be 100644
--- a/api-ref/source/baremetal-api-v1-misc.inc
+++ b/api-ref/source/baremetal-api-v1-misc.inc
@@ -97,6 +97,9 @@ Error response codes: 400 404
 .. versionadded:: 1.36 ``agent_version`` parameter for passing the version of
   the Ironic Python Agent to Ironic during heartbeat
 
+.. versionadded:: 1.62 ``agent_token`` parameter for passing the token of
+  the Ironic Python Agent to Ironic during heartbeat
+
 Request
 -------
 
@@ -105,3 +108,4 @@ Request
     - node_ident: node_ident
     - callback_url: callback_url
     - agent_version: agent_version
+    - agent_token: agent_token
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 86a380ff04..0d3c8b3887 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -129,6 +129,13 @@ volume_target_id:
   required: true
   type: string
 
+agent_token:
+  description: |
+    The token of the ironic-python-agent ramdisk, sent to the Bare Metal
+    service for authentication purposes.
+  in: query
+  required: true
+  type: string
 agent_version:
   description: |
     The version of the ironic-python-agent ramdisk, sent back to the Bare Metal