From d905fda2a3f04a2066746875d09e51a3fe62dfed Mon Sep 17 00:00:00 2001
From: netbirddev <dev@netbird.io>
Date: Fri, 21 Aug 2026 16:22:36 +0000
Subject: [PATCH] Update API pages with v0.77.1

---
 .../resources/edr-fleetdm-integrations.mdx    |  4 +-
 src/pages/ipa/resources/policies.mdx          | 62 ++-----------------
 2 files changed, 6 insertions(+), 60 deletions(-)

diff --git a/src/pages/ipa/resources/edr-fleetdm-integrations.mdx b/src/pages/ipa/resources/edr-fleetdm-integrations.mdx
index 7c521e20..adf1627d 100644
--- a/src/pages/ipa/resources/edr-fleetdm-integrations.mdx
+++ b/src/pages/ipa/resources/edr-fleetdm-integrations.mdx
@@ -38,7 +38,7 @@ export const title = 'EDR FleetDM Integrations'
     <Property name="match_attributes" type="object" required={true}>
         
             <details className="custom-details" open>
-                <summary>Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open-source version. Premium-only attributes are marked accordingly</summary>
+                <summary>Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open source version. Premium-only attributes are marked accordingly</summary>
                 <Properties>
                 
                     <Properties><Property name="disk_encryption_enabled" type="boolean" required={false}>
@@ -954,7 +954,7 @@ echo $response;
     <Property name="match_attributes" type="object" required={true}>
         
             <details className="custom-details" open>
-                <summary>Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open-source version. Premium-only attributes are marked accordingly</summary>
+                <summary>Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open source version. Premium-only attributes are marked accordingly</summary>
                 <Properties>
                 
                     <Properties><Property name="disk_encryption_enabled" type="boolean" required={false}>
diff --git a/src/pages/ipa/resources/policies.mdx b/src/pages/ipa/resources/policies.mdx
index d7e6c009..b0823c38 100644
--- a/src/pages/ipa/resources/policies.mdx
+++ b/src/pages/ipa/resources/policies.mdx
@@ -178,9 +178,6 @@ echo $response;
         "action": "accept",
         "bidirectional": true,
         "protocol": "tcp",
-        "ports": [
-          "80"
-        ],
         "port_ranges": [
           {
             "start": 80,
@@ -367,13 +364,13 @@ echo $response;
         </Property>
     <Property name="ports" type="string[]" required={false}>
         
-            Policy rule affected ports
+            Policy rule affected ports. Mutually exclusive with `port_ranges`. A rule accepts either individual ports or port ranges, not both.
         
         </Property>
     <Property name="port_ranges" type="object[]" required={false}>
         
             <details className="custom-details" open>
-                <summary>Policy rule affected ports ranges list</summary>
+                <summary>Policy rule affected ports ranges list. Mutually exclusive with `ports`. To mix individual ports with ranges in one rule, express each single port as a range with identical start and end values (for example, start 443, end 443).</summary>
                 <Properties>
                 
                     <Properties><Property name="start" type="integer" required={true}>
@@ -489,9 +486,6 @@ curl -X POST https://api.netbird.io/api/policies \
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -542,9 +536,6 @@ let data = JSON.stringify({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -617,9 +608,6 @@ payload = json.dumps({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -692,9 +680,6 @@ func main() {
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -786,9 +771,6 @@ request.body = JSON.dump({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -843,9 +825,6 @@ RequestBody body = RequestBody.create(mediaType, '{
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -916,9 +895,6 @@ curl_setopt_array($curl, array(
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -984,9 +960,6 @@ echo $response;
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1287,9 +1260,6 @@ echo $response;
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1481,13 +1451,13 @@ echo $response;
         </Property>
     <Property name="ports" type="string[]" required={false}>
         
-            Policy rule affected ports
+            Policy rule affected ports. Mutually exclusive with `port_ranges`. A rule accepts either individual ports or port ranges, not both.
         
         </Property>
     <Property name="port_ranges" type="object[]" required={false}>
         
             <details className="custom-details" open>
-                <summary>Policy rule affected ports ranges list</summary>
+                <summary>Policy rule affected ports ranges list. Mutually exclusive with `ports`. To mix individual ports with ranges in one rule, express each single port as a range with identical start and end values (for example, start 443, end 443).</summary>
                 <Properties>
                 
                     <Properties><Property name="start" type="integer" required={true}>
@@ -1603,9 +1573,6 @@ curl -X PUT https://api.netbird.io/api/policies/{policyId} \
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1656,9 +1623,6 @@ let data = JSON.stringify({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1731,9 +1695,6 @@ payload = json.dumps({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1806,9 +1767,6 @@ func main() {
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1900,9 +1858,6 @@ request.body = JSON.dump({
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -1957,9 +1912,6 @@ RequestBody body = RequestBody.create(mediaType, '{
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -2030,9 +1982,6 @@ curl_setopt_array($curl, array(
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,
@@ -2098,9 +2047,6 @@ echo $response;
       "action": "accept",
       "bidirectional": true,
       "protocol": "tcp",
-      "ports": [
-        "80"
-      ],
       "port_ranges": [
         {
           "start": 80,