diff --git a/api/services/ocean/aks/schemas/ocean-autoScale.yaml b/api/services/ocean/aks/schemas/ocean-autoScale.yaml
index 7baa0abb..060c6ae0 100644
--- a/api/services/ocean/aks/schemas/ocean-autoScale.yaml
+++ b/api/services/ocean/aks/schemas/ocean-autoScale.yaml
@@ -3,6 +3,13 @@ description: |
   Object specifying the automatic scaling of an Ocean VNG.
 title: Ocean AKS Auto Scale
 properties:
+  autoHeadroomPercentage:
+    type: integer
+    description: |
+      Optionally set a number between 0-200 to control the percentage of VNG resources dedicated to automatic headroom.
+    example: 5
+    minimum: 0
+    maximum: 200
   headrooms:
     type: array
     description: |
diff --git a/api/services/ocean/aks/schemas/ocean-autoScaler.yaml b/api/services/ocean/aks/schemas/ocean-autoScaler.yaml
index 32f9d802..39efeb50 100644
--- a/api/services/ocean/aks/schemas/ocean-autoScaler.yaml
+++ b/api/services/ocean/aks/schemas/ocean-autoScaler.yaml
@@ -35,6 +35,13 @@ properties:
         maximum: 100
         description: The maximum percentage allowed to scale down in a single scaling action.
         example: 30
+  enableAutomaticAndManualHeadroom:
+    type: boolean
+    description: |
+      Enable mixed mode for manual and automatic headroom.
+      Relevant only when `headroom.automatic.isEnabled` is set to true.
+      If false, Ocean manages headroom automatically without combining with manual VNG headrooms.
+    example: true
   headroom:
     type: object
     description: |