diff --git a/devel/yaml_api.md b/devel/yaml_api.md
index dcee947..9752cf7 100644
--- a/devel/yaml_api.md
+++ b/devel/yaml_api.md
@@ -1328,6 +1328,13 @@ interfaces:
 The `options` subsection of Linux bridge interface `bridge` section holds these
 options:
 
+ * `allow-extra-ports`: Boolean. When set to true, the verification stage of
+   nmstate will ignore extra bridge ports not mentioned in `port` section.
+   This allows external tools to attach ports while nmstate is creating or
+   updating the bridge. This option is not persisted because it only controls
+   nmstate verification stage during apply action. The default value is false,
+   which means verification will enforce bridge port list match with desired
+   state.
  * `gc_timer`: Integer. Ignored when applying.
  * `group-addr`: String.
  * `group-forward-mask`: Integer.
@@ -1444,6 +1451,13 @@ options:
  * `mcast-snooping-enable`: String.
  * `fail-mode`: String.
  * `datapath`: String. Only for DPDK.
+ * `allow-extra-ports`: Boolean. When set to true, the verification stage of
+   nmstate will ignore extra OVS bridge ports not mentioned in `port` section.
+   This allows external tools to attach OVS ports while nmstate is creating
+   or updating the OVS bridge. This option is not persisted because it only
+   controls nmstate verification stage during apply action. The default value
+   is false, which means verification will enforce bridge port list match with
+   desired state.
  * `allow-extra-patch-ports`: Boolean. When set to true, the verification
    stage of nmstate will ignore extra OVS patch port not mentioned in `port`
    section. This allows external tool to attach OVS patch port upon nmstate