Clarify additionalProperties note applies to SDK clients only

.generator/schemas/v1/openapi.yaml

@@ -22719,10 +22719,10 @@ components:
       description: |-
         Response with hourly report of all data billed by Datadog for all organizations.
 
-        Newly added billing dimensions and usage types appear as untyped keys on the
-        `additionalProperties` map instead of as typed fields. Call
-        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
-        at this response level—both typed fields and `additionalProperties` keys.
+        SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. To enumerate every key at this
+        response level—both typed fields and `additionalProperties` keys—make a request to the
+        [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields).
       properties:
         agent_host_top99p:
           description: Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations.
@@ -23948,10 +23948,10 @@ components:
       description: |-
         Global hourly report of all data billed by Datadog for a given organization.
 
-        Newly added billing dimensions and usage types appear as untyped keys on the
-        `additionalProperties` map instead of as typed fields. Call
-        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
-        at this response level—both typed fields and `additionalProperties` keys.
+        SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. To enumerate every key at this
+        response level—both typed fields and `additionalProperties` keys—make a request to the
+        [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields).
       properties:
         account_name:
           description: The account name.
@@ -25196,10 +25196,10 @@ components:
         Response summarizing all usage aggregated across the months in the request for
         all organizations, and broken down by month and by organization.
 
-        Newly added billing dimensions and usage types appear as untyped keys on the
-        `additionalProperties` map instead of as typed fields. Call
-        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
-        at this response level—both typed fields and `additionalProperties` keys.
+        SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. To enumerate every key at this
+        response level—both typed fields and `additionalProperties` keys—make a request to the
+        [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields).
       properties:
         agent_host_top99p_sum:
           description: Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations.
@@ -42879,11 +42879,11 @@ paths:
       description: |-
         Get all usage across your account.
 
-        Newly added billing dimensions and usage types appear as untyped keys on the
+        SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the
         `additionalProperties` map of `UsageSummaryResponse`, `UsageSummaryDate`, and
-        `UsageSummaryDateOrg` instead of as typed fields. Call
-        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
-        at each response level—both typed fields and `additionalProperties` keys.
+        `UsageSummaryDateOrg` instead of as typed fields. To enumerate every key at each
+        response level—both typed fields and `additionalProperties` keys—make a request to the
+        [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields).
 
         This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).
       operationId: GetUsageSummary
@@ -43428,7 +43428,7 @@ paths:
         operator: OR
         permissions:
           - user_access_invite
-  "/api/v1/user/{user_handle}":
+  /api/v1/user/{user_handle}:
     delete:
       description: |-
         Delete a user from an organization.

.generator/schemas/v2/openapi.yaml

@@ -64631,27 +64631,31 @@ components:
     OrgConfigGetResponse:
       description: A response with a single Org Config.
       properties:
-        data: {$ref: "#/components/schemas/OrgConfigRead"}
+        data:
+          $ref: "#/components/schemas/OrgConfigRead"
       required: [data]
       type: object
     OrgConfigListResponse:
       description: A response with multiple Org Configs.
       properties:
         data:
           description: An array of Org Configs.
-          items: {$ref: "#/components/schemas/OrgConfigRead"}
+          items:
+            $ref: "#/components/schemas/OrgConfigRead"
           type: array
       required: [data]
       type: object
     OrgConfigRead:
       description: A single Org Config.
       properties:
-        attributes: {$ref: "#/components/schemas/OrgConfigReadAttributes"}
+        attributes:
+          $ref: "#/components/schemas/OrgConfigReadAttributes"
         id:
           description: A unique identifier for an Org Config.
           example: abcd1234
           type: string
-        type: {$ref: "#/components/schemas/OrgConfigType"}
+        type:
+          $ref: "#/components/schemas/OrgConfigType"
       required: [id, type, attributes]
       type: object
     OrgConfigReadAttributes:
@@ -64688,8 +64692,10 @@ components:
     OrgConfigWrite:
       description: An Org Config write operation.
       properties:
-        attributes: {$ref: "#/components/schemas/OrgConfigWriteAttributes"}
-        type: {$ref: "#/components/schemas/OrgConfigType"}
+        attributes:
+          $ref: "#/components/schemas/OrgConfigWriteAttributes"
+        type:
+          $ref: "#/components/schemas/OrgConfigType"
       required: [type, attributes]
       type: object
     OrgConfigWriteAttributes:
@@ -64702,7 +64708,8 @@ components:
     OrgConfigWriteRequest:
       description: A request to update an Org Config.
       properties:
-        data: {$ref: "#/components/schemas/OrgConfigWrite"}
+        data:
+          $ref: "#/components/schemas/OrgConfigWrite"
       required: [data]
       type: object
     OrgConnection:
@@ -102560,7 +102567,7 @@ paths:
         operator: OR
         permissions:
           - apps_datastore_manage
-  "/api/v2/actions-datastores/{datastore_id}":
+  /api/v2/actions-datastores/{datastore_id}:
     delete:
       description: Deletes a datastore by its unique identifier.
       operationId: DeleteDatastore
@@ -102704,7 +102711,7 @@ paths:
         operator: OR
         permissions:
           - apps_datastore_manage
-  "/api/v2/actions-datastores/{datastore_id}/items":
+  /api/v2/actions-datastores/{datastore_id}/items:
     delete:
       description: Deletes an item from a datastore by its key.
       operationId: DeleteDatastoreItem
@@ -102916,7 +102923,7 @@ paths:
         operator: OR
         permissions:
           - apps_datastore_write
-  "/api/v2/actions-datastores/{datastore_id}/items/bulk":
+  /api/v2/actions-datastores/{datastore_id}/items/bulk:
     delete:
       description: >-
         Deletes multiple items from a datastore by their keys in a single operation.
@@ -105936,7 +105943,7 @@ paths:
           - apps_write
           - connections_resolve
           - workflows_run
-  "/api/v2/app-builder/apps/{app_id}":
+  /api/v2/app-builder/apps/{app_id}:
     delete:
       description: Delete a single app. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access).
       operationId: DeleteApp
@@ -106138,7 +106145,7 @@ paths:
           - apps_write
           - connections_resolve
           - workflows_run
-  "/api/v2/app-builder/apps/{app_id}/deployment":
+  /api/v2/app-builder/apps/{app_id}/deployment:
     delete:
       description: Unpublish an app, removing the live version of the app. Unpublishing creates a new instance of a `deployment` object on the app, with a nil `app_version_id` (`00000000-0000-0000-0000-000000000000`). The app can still be updated and published again in the future. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access).
       operationId: UnpublishApp
@@ -106247,7 +106254,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/favorite":
+  /api/v2/app-builder/apps/{app_id}/favorite:
     patch:
       description: Add or remove an app from the current user's favorites. Favorited apps can be filtered for using the `filter[favorite]` query parameter on the [List Apps](https://docs.datadoghq.com/api/latest/app-builder/#list-apps) endpoint.
       operationId: UpdateAppFavorite
@@ -106303,7 +106310,7 @@ paths:
         operator: OR
         permissions:
           - apps_run
-  "/api/v2/app-builder/apps/{app_id}/protection-level":
+  /api/v2/app-builder/apps/{app_id}/protection-level:
     patch:
       description: Update the publication protection level of an app. When set to `approval_required`, future publishes must go through an approval workflow before going live.
       operationId: UpdateProtectionLevel
@@ -106377,7 +106384,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/publish-request":
+  /api/v2/app-builder/apps/{app_id}/publish-request:
     post:
       description: Create a publish request to ask for approval to publish an app whose protection level is `approval_required`. Publishing happens automatically once the request is approved by a user with the appropriate permissions.
       operationId: CreatePublishRequest
@@ -106450,7 +106457,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/revert":
+  /api/v2/app-builder/apps/{app_id}/revert:
     post:
       description: Revert an app to a previous version. The version to revert to is selected through the `version` query parameter. The reverted version becomes the new latest version of the app.
       operationId: RevertApp
@@ -106518,7 +106525,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/self-service":
+  /api/v2/app-builder/apps/{app_id}/self-service:
     patch:
       description: Enable or disable self-service for an app. Self-service apps can be discovered and run by users in your organization without explicit access being granted.
       operationId: UpdateAppSelfService
@@ -106574,7 +106581,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/tags":
+  /api/v2/app-builder/apps/{app_id}/tags:
     patch:
       description: Replace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed.
       operationId: UpdateAppTags
@@ -106632,7 +106639,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/version-name":
+  /api/v2/app-builder/apps/{app_id}/version-name:
     patch:
       description: Assign a human-readable name to a specific version of an app. The version is selected through the `version` query parameter.
       operationId: UpdateAppVersionName
@@ -106695,7 +106702,7 @@ paths:
         operator: OR
         permissions:
           - apps_write
-  "/api/v2/app-builder/apps/{app_id}/versions":
+  /api/v2/app-builder/apps/{app_id}/versions:
     get:
       description: List the versions of an app. This endpoint is paginated.
       operationId: ListAppVersions
@@ -106775,7 +106782,7 @@ paths:
         permissions:
           - apps_run
           - connections_read
-  "/api/v2/app-builder/blueprint/{blueprint_id}":
+  /api/v2/app-builder/blueprint/{blueprint_id}:
     get:
       description: Retrieve an app blueprint by its ID.
       operationId: GetBlueprint
@@ -106888,7 +106895,7 @@ paths:
           - apps_write
           - connections_read
           - connections_write
-  "/api/v2/app-builder/blueprints/integration-id/{integration_id}":
+  /api/v2/app-builder/blueprints/integration-id/{integration_id}:
     get:
       description: List app blueprints associated with a specific integration ID.
       operationId: GetBlueprintsByIntegrationId
@@ -106939,7 +106946,7 @@ paths:
           - apps_write
           - connections_read
           - connections_write
-  "/api/v2/app-builder/blueprints/slugs/{slugs}":
+  /api/v2/app-builder/blueprints/slugs/{slugs}:
     get:
       description: Retrieve app blueprints by their slugs.
       operationId: GetBlueprintsBySlugs
@@ -144794,12 +144801,17 @@ paths:
                           value_type: bool
                         id: abcd1234
                         type: org_configs
-              schema: {$ref: "#/components/schemas/OrgConfigListResponse"}
+              schema:
+                $ref: "#/components/schemas/OrgConfigListResponse"
           description: OK
-        "400": {$ref: "#/components/responses/BadRequestResponse"}
-        "401": {$ref: "#/components/responses/UnauthorizedResponse"}
-        "403": {$ref: "#/components/responses/ForbiddenResponse"}
-        "429": {$ref: "#/components/responses/TooManyRequestsResponse"}
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "401":
+          $ref: "#/components/responses/UnauthorizedResponse"
+        "403":
+          $ref: "#/components/responses/ForbiddenResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
       summary: List Org Configs
       tags: [Organizations]
       "x-permission":
@@ -144809,7 +144821,8 @@ paths:
     get:
       description: Return the name, description, and value of a specific Org Config.
       operationId: GetOrgConfig
-      parameters: [$ref: "#/components/parameters/OrgConfigName"]
+      parameters:
+        - $ref: "#/components/parameters/OrgConfigName"
       responses:
         "200":
           content:
@@ -144825,13 +144838,19 @@ paths:
                         value_type: bool
                       id: abcd1234
                       type: org_configs
-              schema: {$ref: "#/components/schemas/OrgConfigGetResponse"}
+              schema:
+                $ref: "#/components/schemas/OrgConfigGetResponse"
           description: OK
-        "400": {$ref: "#/components/responses/BadRequestResponse"}
-        "401": {$ref: "#/components/responses/UnauthorizedResponse"}
-        "403": {$ref: "#/components/responses/ForbiddenResponse"}
-        "404": {$ref: "#/components/responses/NotFoundResponse"}
-        "429": {$ref: "#/components/responses/TooManyRequestsResponse"}
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "401":
+          $ref: "#/components/responses/UnauthorizedResponse"
+        "403":
+          $ref: "#/components/responses/ForbiddenResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
       summary: Get a specific Org Config value
       tags: [Organizations]
       "x-permission":
@@ -144840,7 +144859,8 @@ paths:
     patch:
       description: Update the value of a specific Org Config.
       operationId: UpdateOrgConfig
-      parameters: [$ref: "#/components/parameters/OrgConfigName"]
+      parameters:
+        - $ref: "#/components/parameters/OrgConfigName"
       requestBody:
         content:
           application/json:
@@ -144851,7 +144871,8 @@ paths:
                     attributes:
                       value: UTC
                     type: org_configs
-            schema: {$ref: "#/components/schemas/OrgConfigWriteRequest"}
+            schema:
+              $ref: "#/components/schemas/OrgConfigWriteRequest"
         required: true
       responses:
         "200":
@@ -144868,13 +144889,19 @@ paths:
                         value_type: bool
                       id: abcd1234
                       type: org_configs
-              schema: {$ref: "#/components/schemas/OrgConfigGetResponse"}
+              schema:
+                $ref: "#/components/schemas/OrgConfigGetResponse"
           description: OK
-        "400": {$ref: "#/components/responses/BadRequestResponse"}
-        "401": {$ref: "#/components/responses/UnauthorizedResponse"}
-        "403": {$ref: "#/components/responses/ForbiddenResponse"}
-        "404": {$ref: "#/components/responses/NotFoundResponse"}
-        "429": {$ref: "#/components/responses/TooManyRequestsResponse"}
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "401":
+          $ref: "#/components/responses/UnauthorizedResponse"
+        "403":
+          $ref: "#/components/responses/ForbiddenResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
       summary: Update a specific Org Config
       tags: [Organizations]
       "x-permission":

src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java

@@ -7231,11 +7231,13 @@ public CompletableFuture<UsageSummaryResponse> getUsageSummaryAsync(
   /**
    * Get all usage across your account.
    *
-   * <p>Newly added billing dimensions and usage types appear as untyped keys on the <code>
-   * additionalProperties</code> map of <code>UsageSummaryResponse</code>, <code>UsageSummaryDate
-   * </code>, and <code>UsageSummaryDateOrg</code> instead of as typed fields. Call <code>
-   * GET /api/v2/usage/summary/available_fields</code> to enumerate every key returned at each
-   * response level—both typed fields and <code>additionalProperties</code> keys.
+   * <p>SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the
+   * <code>additionalProperties</code> map of <code>UsageSummaryResponse</code>, <code>
+   * UsageSummaryDate</code>, and <code>UsageSummaryDateOrg</code> instead of as typed fields. To
+   * enumerate every key at each response level—both typed fields and <code>additionalProperties
+   * </code> keys—make a request to the <a
+   * href="https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields">Get
+   * available fields for usage summary API</a>.
    *
    * <p>This endpoint is only accessible for <a
    * href="https://docs.datadoghq.com/account_management/multi_organization/">parent-level