diff --git a/api-ref/source/baremetal-api-v1-chassis.inc b/api-ref/source/baremetal-api-v1-chassis.inc
index 2bb643ee1c..39563dcac0 100644
--- a/api-ref/source/baremetal-api-v1-chassis.inc
+++ b/api-ref/source/baremetal-api-v1-chassis.inc
@@ -68,6 +68,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
    - fields: fields
+   - chassis_id: chassis_ident
 
 Response Parameters
 -------------------
@@ -105,7 +106,7 @@ The BODY of the PATCH request must be a JSON PATCH document, adhering to
 
 .. rest_parameters:: parameters.yaml
 
-   - chassis: chassis
+   - chassis_id: chassis_ident
    - description: description
    - extra: extra
 
@@ -148,6 +149,10 @@ Deletes a chassis.
 Request
 -------
 
+.. rest_parameters:: parameters.yaml
+
+  - chassis_id: chassis_ident
+
 Create chassis
 ==============
 
diff --git a/api-ref/source/baremetal-api-v1-nodes-vifs.inc b/api-ref/source/baremetal-api-v1-nodes-vifs.inc
index 34834ab55c..3d0bbfe674 100644
--- a/api-ref/source/baremetal-api-v1-nodes-vifs.inc
+++ b/api-ref/source/baremetal-api-v1-nodes-vifs.inc
@@ -27,6 +27,7 @@ Response
 
     - id: node_vif_ident
     - vifs: n_vifs
+    - node_ident: node_ident
 
 **Example list of VIFs that are attached to the node:**
 
@@ -51,6 +52,7 @@ Request
 .. rest_parameters:: parameters.yaml
 
     - id: node_vif_ident
+    - node_ident: node_ident
 
 **Example request to attach a VIF to a Node:**
 
@@ -60,6 +62,11 @@ Request
 Detach VIF from a node
 ======================
 
+.. rest_parameters:: parameters.yaml
+
+    - node_ident: node_ident
+    - node_vif_ident: node_vif_ident
+
 .. rest_method:: DELETE /v1/nodes/{node_ident}/vifs/{node_vif_ident}
 
 Detach VIF from a Node.