diff --git a/.apigentools-info b/.apigentools-info
index ddd8aa6056e7..cf44b76600a3 100644
--- a/.apigentools-info
+++ b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-08-17 17:20:40.199652",
-            "spec_repo_commit": "357af604"
+            "regenerated": "2023-08-17 19:37:29.403596",
+            "spec_repo_commit": "bb17cef0"
         },
         "v2": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-08-17 17:20:40.214370",
-            "spec_repo_commit": "357af604"
+            "regenerated": "2023-08-17 19:37:29.416739",
+            "spec_repo_commit": "bb17cef0"
         }
     }
 }
\ No newline at end of file
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index 573451b05dde..338819c1356b 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -7844,7 +7844,8 @@ components:
       description: Paging settings
       properties:
         cursor:
-          description: The returned paging point to use to get the next results
+          description: 'The returned paging point to use to get the next results.
+            Note: at most 1000 results can be paged.'
           example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
           type: string
       type: object
@@ -8329,7 +8330,11 @@ components:
           $ref: '#/components/schemas/LogsGroupByHistogram'
         limit:
           default: 10
-          description: The maximum buckets to return for this group by
+          description: 'The maximum buckets to return for this group by. Note: at
+            most 10000 buckets are allowed.
+
+            If grouping by multiple facets, the product of limits must not exceed
+            10000.'
           format: int64
           type: integer
         missing:
@@ -8344,7 +8349,7 @@ components:
     LogsGroupByHistogram:
       description: 'Used to perform a histogram computation (only for measure facets).
 
-        Note: At most 100 buckets are allowed, the number of buckets is (max - min)/interval.'
+        Note: at most 100 buckets are allowed, the number of buckets is (max - min)/interval.'
       properties:
         interval:
           description: The bin size of the histogram buckets
@@ -8722,7 +8727,7 @@ components:
     LogsQueryOptions:
       description: 'Global query options that are used during the query.
 
-        Note: You should only supply timezone or time offset but not both otherwise
+        Note: you should supply either timezone or time offset, but not both. Otherwise,
         the query will fail.'
       properties:
         timeOffset:
@@ -8766,7 +8771,7 @@ components:
       properties:
         after:
           description: 'The cursor to use to get the next results, if any. To make
-            the next request, use the same.
+            the next request, use the same
 
             parameters with the addition of the `page[cursor]`.'
           example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==
diff --git a/packages/datadog-api-client-v2/models/LogsAggregateRequest.ts b/packages/datadog-api-client-v2/models/LogsAggregateRequest.ts
index ddadb70c2d43..200ef694c3ff 100644
--- a/packages/datadog-api-client-v2/models/LogsAggregateRequest.ts
+++ b/packages/datadog-api-client-v2/models/LogsAggregateRequest.ts
@@ -29,7 +29,7 @@ export class LogsAggregateRequest {
   "groupBy"?: Array<LogsGroupBy>;
   /**
    * Global query options that are used during the query.
-   * Note: You should only supply timezone or time offset but not both otherwise the query will fail.
+   * Note: you should supply either timezone or time offset, but not both. Otherwise, the query will fail.
    */
   "options"?: LogsQueryOptions;
   /**
diff --git a/packages/datadog-api-client-v2/models/LogsAggregateRequestPage.ts b/packages/datadog-api-client-v2/models/LogsAggregateRequestPage.ts
index ede2642482f1..c8ef415f9fb3 100644
--- a/packages/datadog-api-client-v2/models/LogsAggregateRequestPage.ts
+++ b/packages/datadog-api-client-v2/models/LogsAggregateRequestPage.ts
@@ -11,7 +11,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
  */
 export class LogsAggregateRequestPage {
   /**
-   * The returned paging point to use to get the next results
+   * The returned paging point to use to get the next results. Note: at most 1000 results can be paged.
    */
   "cursor"?: string;
 
diff --git a/packages/datadog-api-client-v2/models/LogsGroupBy.ts b/packages/datadog-api-client-v2/models/LogsGroupBy.ts
index 2b5806f9d8ea..3b476b107892 100644
--- a/packages/datadog-api-client-v2/models/LogsGroupBy.ts
+++ b/packages/datadog-api-client-v2/models/LogsGroupBy.ts
@@ -20,11 +20,12 @@ export class LogsGroupBy {
   "facet": string;
   /**
    * Used to perform a histogram computation (only for measure facets).
-   * Note: At most 100 buckets are allowed, the number of buckets is (max - min)/interval.
+   * Note: at most 100 buckets are allowed, the number of buckets is (max - min)/interval.
    */
   "histogram"?: LogsGroupByHistogram;
   /**
-   * The maximum buckets to return for this group by
+   * The maximum buckets to return for this group by. Note: at most 10000 buckets are allowed.
+   * If grouping by multiple facets, the product of limits must not exceed 10000.
    */
   "limit"?: number;
   /**
diff --git a/packages/datadog-api-client-v2/models/LogsGroupByHistogram.ts b/packages/datadog-api-client-v2/models/LogsGroupByHistogram.ts
index 1faf241ded95..d5fc676c90a2 100644
--- a/packages/datadog-api-client-v2/models/LogsGroupByHistogram.ts
+++ b/packages/datadog-api-client-v2/models/LogsGroupByHistogram.ts
@@ -8,7 +8,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
  * Used to perform a histogram computation (only for measure facets).
- * Note: At most 100 buckets are allowed, the number of buckets is (max - min)/interval.
+ * Note: at most 100 buckets are allowed, the number of buckets is (max - min)/interval.
  */
 export class LogsGroupByHistogram {
   /**
diff --git a/packages/datadog-api-client-v2/models/LogsListRequest.ts b/packages/datadog-api-client-v2/models/LogsListRequest.ts
index 302b51051616..0d8ed36e44e0 100644
--- a/packages/datadog-api-client-v2/models/LogsListRequest.ts
+++ b/packages/datadog-api-client-v2/models/LogsListRequest.ts
@@ -20,7 +20,7 @@ export class LogsListRequest {
   "filter"?: LogsQueryFilter;
   /**
    * Global query options that are used during the query.
-   * Note: You should only supply timezone or time offset but not both otherwise the query will fail.
+   * Note: you should supply either timezone or time offset, but not both. Otherwise, the query will fail.
    */
   "options"?: LogsQueryOptions;
   /**
diff --git a/packages/datadog-api-client-v2/models/LogsQueryOptions.ts b/packages/datadog-api-client-v2/models/LogsQueryOptions.ts
index 804d097efd38..e945e581ac81 100644
--- a/packages/datadog-api-client-v2/models/LogsQueryOptions.ts
+++ b/packages/datadog-api-client-v2/models/LogsQueryOptions.ts
@@ -8,7 +8,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
  * Global query options that are used during the query.
- * Note: You should only supply timezone or time offset but not both otherwise the query will fail.
+ * Note: you should supply either timezone or time offset, but not both. Otherwise, the query will fail.
  */
 export class LogsQueryOptions {
   /**
diff --git a/packages/datadog-api-client-v2/models/LogsResponseMetadataPage.ts b/packages/datadog-api-client-v2/models/LogsResponseMetadataPage.ts
index 87156d63dbd1..7225a4e48cb1 100644
--- a/packages/datadog-api-client-v2/models/LogsResponseMetadataPage.ts
+++ b/packages/datadog-api-client-v2/models/LogsResponseMetadataPage.ts
@@ -11,7 +11,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
  */
 export class LogsResponseMetadataPage {
   /**
-   * The cursor to use to get the next results, if any. To make the next request, use the same.
+   * The cursor to use to get the next results, if any. To make the next request, use the same
    * parameters with the addition of the `page[cursor]`.
    */
   "after"?: string;