diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml
index 5f6006a6baa..2562b6db95b 100644
--- a/.generator/schemas/v1/openapi.yaml
+++ b/.generator/schemas/v1/openapi.yaml
@@ -2782,6 +2782,7 @@ components:
         peer_tags:
           description: Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.).
           items:
+            description: "A tag identifying a specific downstream entity (for example: peer.service, peer.db_instance)."
             example: "peer.service:my-service"
             type: string
           type: array
@@ -6647,6 +6648,7 @@ components:
         sources:
           additionalProperties:
             items:
+              description: A fallback source attribute name.
               type: string
             type: array
           description: Fallback sources used to populate value of field.
@@ -6695,6 +6697,7 @@ components:
           description: Optional list of profiles to modify the schema.
           example: ["security_control", "host"]
           items:
+            description: A profile name that modifies the schema behavior.
             type: string
           type: array
         schema_type:
@@ -7808,6 +7811,7 @@ components:
           description: Columns to group results by.
           example: ["col1", "col2"]
           items:
+            description: A column name to group results by.
             type: string
           type: array
         model_type_override:
@@ -7827,6 +7831,7 @@ components:
           description: Optional grouping fields for aggregation.
           example: ["entity_id"]
           items:
+            description: A field name to group results by.
             type: string
           type: array
         measure:
@@ -11161,8 +11166,10 @@ components:
       description: Product Analytics audience account subquery.
       properties:
         name:
+          description: The name of the account subquery.
           type: string
         query:
+          description: The query string for the account subquery.
           type: string
       type: object
     ProductAnalyticsAudienceFilters:
@@ -11173,6 +11180,7 @@ components:
             $ref: "#/components/schemas/ProductAnalyticsAudienceAccountSubquery"
           type: array
         filter_condition:
+          description: An optional filter condition applied to the audience subquery.
           type: string
         segments:
           items:
@@ -11184,26 +11192,33 @@ components:
           type: array
       type: object
     ProductAnalyticsAudienceOccurrenceFilter:
+      description: Filter applied to occurrence counts when building a Product Analytics audience.
       properties:
         operator:
+          description: "The comparison operator used for the occurrence filter (for example: `gt`, `lt`, `eq`)."
           type: string
         value:
+          description: The threshold value to compare occurrence counts against.
           type: string
       type: object
     ProductAnalyticsAudienceSegmentSubquery:
       description: Product Analytics audience segment subquery.
       properties:
         name:
+          description: The name of the segment subquery.
           type: string
         segment_id:
+          description: The unique identifier of the segment.
           type: string
       type: object
     ProductAnalyticsAudienceUserSubquery:
       description: Product Analytics audience user subquery.
       properties:
         name:
+          description: The name of the user subquery.
           type: string
         query:
+          description: The query string for the user subquery.
           type: string
       type: object
     QuerySortOrder:
@@ -11772,6 +11787,7 @@ components:
         - $ref: "#/components/schemas/SLOCountDefinitionWithBadEventsFormula"
     SLOCountDefinitionWithBadEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a bad events formula alongside a good events formula.
       properties:
         bad_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -11798,6 +11814,7 @@ components:
       type: object
     SLOCountDefinitionWithTotalEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a total events formula alongside a good events formula.
       properties:
         good_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -13004,6 +13021,7 @@ components:
           description: Fields to group by.
           example: ["source", "destination"]
           items:
+            description: A field name to group by.
             type: string
           type: array
         limit:
@@ -13626,6 +13644,7 @@ components:
             Always included in service level objective responses (but may be empty).
           example: ["env:prod", "app:core"]
           items:
+            description: A tag associated with the service level objective.
             type: string
           type: array
         created_at:
@@ -13649,6 +13668,7 @@ components:
         env_tags:
           description: Tags with the `env` tag key.
           items:
+            description: A tag with the `env` tag key.
             type: string
           type: array
         groups:
@@ -13693,6 +13713,7 @@ components:
         service_tags:
           description: Tags with the `service` tag key.
           items:
+            description: A tag with the `service` tag key.
             type: string
           type: array
         slo_type:
@@ -13702,6 +13723,7 @@ components:
         team_tags:
           description: Tags with the `team` tag key.
           items:
+            description: A tag with the `team` tag key.
             type: string
           type: array
         thresholds:
@@ -14712,6 +14734,7 @@ components:
           description: The tag values.
           example: ["env"]
           items:
+            description: A tag value string.
             minLength: 1
             type: string
           type: array
@@ -17989,6 +18012,7 @@ components:
         blockedRequestPatterns:
           description: Array of URL patterns to block.
           items:
+            description: A URL pattern to block during the Synthetic test.
             type: string
           type: array
         checkCertificateRevocation:
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index 45c7a5c5909..a3552282a2a 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -25792,6 +25792,7 @@ components:
           description: Tags associated with the feature flag.
           example: []
           items:
+            description: A tag associated with the feature flag.
             type: string
           type: array
         updated_at:
@@ -25845,6 +25846,7 @@ components:
             - "test-feature-flag"
             - "env-search-term"
           items:
+            description: A query string targeting the environment.
             type: string
           type: array
         is_production:
diff --git a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceAccountSubquery.java b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceAccountSubquery.java
index c517e4af22a..caa8f7b0b4e 100644
--- a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceAccountSubquery.java
+++ b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceAccountSubquery.java
@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceAccountSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the account subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceAccountSubquery query(String query) {
   }
 
   /**
-   * Getquery
+   * The query string for the account subquery.
    *
    * @return query
    */
diff --git a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceFilters.java b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceFilters.java
index 002940bb8ec..c14dcc558e5 100644
--- a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceFilters.java
+++ b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceFilters.java
@@ -82,7 +82,7 @@ public ProductAnalyticsAudienceFilters filterCondition(String filterCondition) {
   }
 
   /**
-   * GetfilterCondition
+   * An optional filter condition applied to the audience subquery.
    *
    * @return filterCondition
    */
diff --git a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceOccurrenceFilter.java b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceOccurrenceFilter.java
index 22a3771ccb6..cec344e00e4 100644
--- a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceOccurrenceFilter.java
+++ b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceOccurrenceFilter.java
@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Filter applied to occurrence counts when building a Product Analytics audience. */
 @JsonPropertyOrder({
   ProductAnalyticsAudienceOccurrenceFilter.JSON_PROPERTY_OPERATOR,
   ProductAnalyticsAudienceOccurrenceFilter.JSON_PROPERTY_VALUE
@@ -37,7 +37,8 @@ public ProductAnalyticsAudienceOccurrenceFilter operator(String operator) {
   }
 
   /**
-   * Getoperator
+   * The comparison operator used for the occurrence filter (for example: <code>gt</code>, <code>lt
+   * </code>, <code>eq</code>).
    *
    * @return operator
    */
@@ -58,7 +59,7 @@ public ProductAnalyticsAudienceOccurrenceFilter value(String value) {
   }
 
   /**
-   * Getvalue
+   * The threshold value to compare occurrence counts against.
    *
    * @return value
    */
diff --git a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceSegmentSubquery.java b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceSegmentSubquery.java
index 591f7ba5416..1a187cc81ce 100644
--- a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceSegmentSubquery.java
+++ b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceSegmentSubquery.java
@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceSegmentSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the segment subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceSegmentSubquery segmentId(String segmentId) {
   }
 
   /**
-   * GetsegmentId
+   * The unique identifier of the segment.
    *
    * @return segmentId
    */
diff --git a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceUserSubquery.java b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceUserSubquery.java
index cb1fec701fe..44a938938a4 100644
--- a/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceUserSubquery.java
+++ b/src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceUserSubquery.java
@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceUserSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the user subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceUserSubquery query(String query) {
   }
 
   /**
-   * Getquery
+   * The query string for the user subquery.
    *
    * @return query
    */
diff --git a/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithBadEventsFormula.java b/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithBadEventsFormula.java
index b4135b67a5b..f911421fc5e 100644
--- a/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithBadEventsFormula.java
+++ b/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithBadEventsFormula.java
@@ -15,7 +15,7 @@
 import java.util.List;
 import java.util.Objects;
 
-/** */
+/** SLO count definition using a bad events formula alongside a good events formula. */
 @JsonPropertyOrder({
   SLOCountDefinitionWithBadEventsFormula.JSON_PROPERTY_BAD_EVENTS_FORMULA,
   SLOCountDefinitionWithBadEventsFormula.JSON_PROPERTY_GOOD_EVENTS_FORMULA,
diff --git a/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithTotalEventsFormula.java b/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithTotalEventsFormula.java
index 95e2e4325e2..05d82cd0d35 100644
--- a/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithTotalEventsFormula.java
+++ b/src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithTotalEventsFormula.java
@@ -15,7 +15,7 @@
 import java.util.List;
 import java.util.Objects;
 
-/** */
+/** SLO count definition using a total events formula alongside a good events formula. */
 @JsonPropertyOrder({
   SLOCountDefinitionWithTotalEventsFormula.JSON_PROPERTY_GOOD_EVENTS_FORMULA,
   SLOCountDefinitionWithTotalEventsFormula.JSON_PROPERTY_QUERIES,
diff --git a/src/main/java/com/datadog/api/client/v1/model/SankeyRumQuery.java b/src/main/java/com/datadog/api/client/v1/model/SankeyRumQuery.java
index 1152f17740b..a1af04ae1e7 100644
--- a/src/main/java/com/datadog/api/client/v1/model/SankeyRumQuery.java
+++ b/src/main/java/com/datadog/api/client/v1/model/SankeyRumQuery.java
@@ -220,7 +220,7 @@ public SankeyRumQuery occurrences(ProductAnalyticsAudienceOccurrenceFilter occur
   }
 
   /**
-   * Getoccurrences
+   * Filter applied to occurrence counts when building a Product Analytics audience.
    *
    * @return occurrences
    */