diff --git a/api-ref/source/baremetal-api-v1-get-vmedia.inc b/api-ref/source/baremetal-api-v1-get-vmedia.inc
index 188de1ccab..68e762474a 100644
--- a/api-ref/source/baremetal-api-v1-get-vmedia.inc
+++ b/api-ref/source/baremetal-api-v1-get-vmedia.inc
@@ -1,8 +1,8 @@
 .. -*- rst -*-
 
-=====================================
+=========================
 Get Virtual Media (nodes)
-=====================================
+=========================
 
 .. versionadded:: 1.93
 
@@ -10,7 +10,7 @@ Get a list of virtual media devices attached to a node using
 the ``v1/nodes/{node_ident}/vmedia`` endpoint.
 
 Get virtual media devices attached to a node
-================================
+============================================
 
 .. rest_method:: GET /v1/nodes/{node_ident}/vmedia
 
diff --git a/api-ref/source/baremetal-api-v1-node-management.inc b/api-ref/source/baremetal-api-v1-node-management.inc
index 46ba106fce..43fb57d240 100644
--- a/api-ref/source/baremetal-api-v1-node-management.inc
+++ b/api-ref/source/baremetal-api-v1-node-management.inc
@@ -35,7 +35,7 @@ depending on the service configuration.
 
 
 Validate Node
-===============
+=============
 
 .. rest_method:: GET /v1/nodes/{node_ident}/validate
 
@@ -85,7 +85,7 @@ the Node's driver does not support that interface.
 
 
 Set Maintenance Flag
-=============================
+====================
 
 .. rest_method:: PUT /v1/nodes/{node_ident}/maintenance
 
@@ -110,7 +110,7 @@ Request
 .. literalinclude:: samples/node-maintenance-request.json
 
 Clear Maintenance Flag
-==============================
+======================
 
 .. rest_method:: DELETE /v1/nodes/{node_ident}/maintenance
 
@@ -198,7 +198,7 @@ Response
 
 
 Get Supported Boot Devices
-===========================
+==========================
 
 .. rest_method:: GET /v1/nodes/{node_ident}/management/boot_device/supported
 
diff --git a/api-ref/source/baremetal-api-v1-nodes-ports.inc b/api-ref/source/baremetal-api-v1-nodes-ports.inc
index 9c8a0386d3..a55756b3e2 100644
--- a/api-ref/source/baremetal-api-v1-nodes-ports.inc
+++ b/api-ref/source/baremetal-api-v1-nodes-ports.inc
@@ -12,7 +12,7 @@ by accessing the Port resources under the ``/v1/ports`` endpoint.
 
 
 List Ports by Node
-===================
+==================
 
 .. rest_method:: GET /v1/nodes/{node_ident}/ports