diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index 380a344138b..d9c881cd836 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -78107,7 +78107,13 @@ paths:
         cursorPath: meta.page.cursor
         limitParam: page[limit]
         resultsPath: data
-      x-unstable: '**Note**: This endpoint is in public beta.
+      x-unstable: '**Note**: This endpoint uses the legacy security findings data
+        model and is planned for deprecation.
+
+        Use the [search security findings endpoint](https://docs.datadoghq.com/api/latest/security-monitoring/#search-security-findings),
+
+        which is based on the [new security findings schema](https://docs.datadoghq.com/security/guide/findings-schema/),
+        to search security findings.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
     patch:
@@ -78207,7 +78213,13 @@ paths:
       summary: Get a finding
       tags:
       - Security Monitoring
-      x-unstable: '**Note**: This endpoint is in public beta.
+      x-unstable: '**Note**: This endpoint uses the legacy security findings data
+        model and is planned for deprecation.
+
+        Use the [search security findings endpoint](https://docs.datadoghq.com/api/latest/security-monitoring/#search-security-findings),
+
+        which is based on the [new security findings schema](https://docs.datadoghq.com/security/guide/findings-schema/),
+        to search security findings.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/powerpacks:
@@ -82153,15 +82165,16 @@ paths:
         - security_monitoring_cws_agent_rules_read
   /api/v2/security/findings:
     get:
-      description: 'Get a list of security findings that match a search query.
+      description: 'Get a list of security findings that match a search query. [See
+        the schema for security findings](https://docs.datadoghq.com/security/guide/findings-schema/).
 
 
         ### Query Syntax
 
 
         This endpoint uses the logs query syntax. Findings attributes (living in the
-        custom. namespace) are prefixed by @ when queried. Tags are queried without
-        a prefix.
+        attributes.attributes. namespace) are prefixed by @ when queried. Tags are
+        queried without a prefix.
 
 
         Example: `@severity:(critical OR high) @status:open team:platform`'
@@ -82452,13 +82465,14 @@ paths:
         Please check the documentation regularly for updates.'
   /api/v2/security/findings/search:
     post:
-      description: 'Get a list of security findings that match a search query.
+      description: 'Get a list of security findings that match a search query. [See
+        the schema for security findings](https://docs.datadoghq.com/security/guide/findings-schema/).
 
 
         ### Query Syntax
 
 
-        The API uses the logs query syntax. Findings attributes (living in the custom.
+        The API uses the logs query syntax. Findings attributes (living in the attributes.attributes.
         namespace) are prefixed by @ when queried. Tags are queried without a prefix.
 
 
diff --git a/src/main/java/com/datadog/api/client/v2/api/SecurityMonitoringApi.java b/src/main/java/com/datadog/api/client/v2/api/SecurityMonitoringApi.java
index a652365ac77..6d027879bb8 100644
--- a/src/main/java/com/datadog/api/client/v2/api/SecurityMonitoringApi.java
+++ b/src/main/java/com/datadog/api/client/v2/api/SecurityMonitoringApi.java
@@ -8864,12 +8864,15 @@ public PaginationIterable<SecurityFindingsData> listSecurityFindingsWithPaginati
   }
 
   /**
-   * Get a list of security findings that match a search query.
+   * Get a list of security findings that match a search query. <a
+   * href="https://docs.datadoghq.com/security/guide/findings-schema/">See the schema for security
+   * findings</a>.
    *
    * <h3>Query Syntax</h3>
    *
-   * <p>This endpoint uses the logs query syntax. Findings attributes (living in the custom.
-   * namespace) are prefixed by @ when queried. Tags are queried without a prefix.
+   * <p>This endpoint uses the logs query syntax. Findings attributes (living in the
+   * attributes.attributes. namespace) are prefixed by @ when queried. Tags are queried without a
+   * prefix.
    *
    * <p>Example: <code>@severity:(critical OR high) @status:open team:platform</code>
    *
@@ -12554,12 +12557,15 @@ public PaginationIterable<SecurityFindingsData> searchSecurityFindingsWithPagina
   }
 
   /**
-   * Get a list of security findings that match a search query.
+   * Get a list of security findings that match a search query. <a
+   * href="https://docs.datadoghq.com/security/guide/findings-schema/">See the schema for security
+   * findings</a>.
    *
    * <h3>Query Syntax</h3>
    *
-   * <p>The API uses the logs query syntax. Findings attributes (living in the custom. namespace)
-   * are prefixed by @ when queried. Tags are queried without a prefix.
+   * <p>The API uses the logs query syntax. Findings attributes (living in the
+   * attributes.attributes. namespace) are prefixed by @ when queried. Tags are queried without a
+   * prefix.
    *
    * <p>Example: <code>@severity:(critical OR high) @status:open team:platform</code>
    *