Uncomment edit dataset block, add dataset limitations into endpoint descriptions (#30624)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: 2 people

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-24 19:59:19.182981",
-            "spec_repo_commit": "c09ac236"
+            "regenerated": "2025-07-25 14:08:30.909404",
+            "spec_repo_commit": "e4f653f1"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-24 19:59:28.761694",
-            "spec_repo_commit": "c09ac236"
+            "regenerated": "2025-07-25 14:08:40.468056",
+            "spec_repo_commit": "e4f653f1"
         }
     }
 }

config/_default/menus/api.en.yaml

@@ -6573,6 +6573,18 @@ menu:
       url: /api/latest/datasets/
       identifier: datasets
       generated: true
+    - name: Edit a dataset
+      url: '#edit-a-dataset'
+      identifier: datasets-edit-a-dataset
+      parent: datasets
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - UpdateDataset
+        unstable: []
+        order: 4
     - name: Get a single dataset by ID
       url: '#get-a-single-dataset-by-id'
       identifier: datasets-get-a-single-dataset-by-id

content/en/api/v2/datasets/examples.json

@@ -12342,7 +12342,14 @@ components:
       - type
       type: object
     Dataset:
-      description: Dataset object.
+      description: "Dataset object.\n\n### Datasets Constraints\n- **Tag Limit per
+        Dataset**:\n  - Each restricted dataset supports a maximum of 10 key:value
+        pairs per product.\n\n- **Tag Key Rules per Telemetry Type**:\n  - Only one
+        tag key or attribute may be used to define access within a single telemetry
+        type.\n  - The same or different tag key may be used across different telemetry
+        types.\n\n- **Tag Value Uniqueness**:\n  - Tag values must be unique within
+        a single dataset.\n  - A tag value used in one dataset cannot be reused in
+        another dataset of the same telemetry type."
       properties:
         attributes:
           $ref: '#/components/schemas/DatasetAttributes'
@@ -12420,6 +12427,14 @@ components:
       required:
       - data
       type: object
+    DatasetUpdateRequest:
+      description: Edit request for a dataset.
+      properties:
+        data:
+          $ref: '#/components/schemas/Dataset'
+      required:
+      - data
+      type: object
     Date:
       description: Date as Unix timestamp in milliseconds.
       example: 1722439510282
@@ -16194,10 +16209,9 @@ components:
           type: array
         product:
           description: 'Name of the product the dataset is for. Possible values are
-            ''apm'', ''rum'', ''synthetics'',
+            ''apm'', ''rum'',
 
-            ''metrics'', ''logs'', ''sd_repoinfo'', ''error_tracking'', ''cloud_cost'',
-            and ''ml_obs''.'
+            ''metrics'', ''logs'', ''error_tracking'', and ''cloud_cost''.'
           example: logs
           type: string
       required:
@@ -49630,6 +49644,47 @@ paths:
         permissions: []
       x-undo:
         type: safe
+    put:
+      description: Edits the dataset associated with the ID.
+      operationId: UpdateDataset
+      parameters:
+      - $ref: '#/components/parameters/DatasetID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DatasetUpdateRequest'
+        description: Dataset payload
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DatasetResponseSingle'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Edit a dataset
+      tags:
+      - Datasets
+      x-codegen-request-body-name: body
+      x-menu-order: 4
+      x-permission:
+        operator: OPEN
+        permissions: []
+      x-undo:
+        type: idempotent
   /api/v2/domain_allowlist:
     get:
       description: Get the domain allowlist for an organization.