Add OpenAPI spec for authn-validation /api/v2/validate endpoint

.generator/schemas/v1/openapi.yaml

@@ -791,11 +791,6 @@ components:
           items:
             $ref: "#/components/schemas/ResourceProviderConfig"
           type: array
-        secretless_auth_enabled:
-          description: |-
-            (Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.
-          example: true
-          type: boolean
         tenant_name:
           description: Your Azure Active Directory ID.
           example: "testc44-1234-5678-9101-cc00736ftest"

.generator/schemas/v2/openapi.yaml

@@ -81822,6 +81822,61 @@ components:
       description: The title of the event.
       example: "The event title"
       type: string
+    ValidateV2Attributes:
+      description: Attributes of the API key validation response.
+      properties:
+        api_key_id:
+          description: The UUID of the API key.
+          example: "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"
+          type: string
+        api_key_scopes:
+          description: List of scope names associated with the API key.
+          example:
+            - "remote_config_read"
+          items:
+            type: string
+          type: array
+        valid:
+          description: Whether the API key is valid.
+          example: true
+          type: boolean
+      required:
+        - valid
+        - api_key_scopes
+        - api_key_id
+      type: object
+    ValidateV2Data:
+      description: Data object containing the API key validation result.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/ValidateV2Attributes"
+        id:
+          description: The UUID of the organization associated with the API key.
+          example: "550e8400-e29b-41d4-a716-446655440000"
+          type: string
+        type:
+          $ref: "#/components/schemas/ValidateV2Type"
+      required:
+        - id
+        - type
+        - attributes
+      type: object
+    ValidateV2Response:
+      description: Response for the API key validation endpoint.
+      properties:
+        data:
+          $ref: "#/components/schemas/ValidateV2Data"
+      required:
+        - data
+      type: object
+    ValidateV2Type:
+      description: Resource type for the API key validation response.
+      enum:
+        - validate_v2
+      example: validate_v2
+      type: string
+      x-enum-varnames:
+        - ValidateV2
     ValidationError:
       description: Represents a single validation error, including a human-readable title and metadata.
       properties:
@@ -134478,6 +134533,47 @@ paths:
         operator: OR
         permissions:
           - teams_read
+  /api/v2/validate:
+    get:
+      description: Check if the API key is valid. Returns the organization UUID, API key ID, and associated scopes.
+      operationId: ValidateV2
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        api_key_id: "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"
+                        api_key_scopes:
+                          - "remote_config_read"
+                        valid: true
+                      id: "550e8400-e29b-41d4-a716-446655440000"
+                      type: "validate_v2"
+              schema:
+                $ref: "#/components/schemas/ValidateV2Response"
+          description: OK
+        "403":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Forbidden
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+      summary: Validate API key
+      tags:
+        - Key Management
+      "x-permission":
+        operator: OPEN
+        permissions: []
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/widgets/{experience_type}:
     get:
       description: Search and list widgets for a given experience type. Supports filtering by widget type, creator, title, and tags, as well as sorting and pagination.

cassettes/features/v1/azure_integration/Delete-an-Azure-integration-returns-OK-response.frozen

@@ -1 +1 @@
-2026-05-04T13:56:51.846Z
+2024-12-17T21:43:00.678Z

cassettes/features/v1/azure_integration/Update-an-Azure-integration-returns-OK-response.frozen

@@ -1 +1 @@
-2026-05-04T13:56:52.686Z
+2024-12-17T21:43:01.129Z

examples/v1/azure-integration/UpdateAzureHostFilters.rb

@@ -26,7 +26,6 @@
       namespace: "Microsoft.Compute",
     }),
   ],
-  secretless_auth_enabled: true,
   tenant_name: "testc44-1234-5678-9101-cc00736ftest",
   usage_metrics_enabled: true,
 })

examples/v1/azure-integration/UpdateAzureIntegration.rb

@@ -18,7 +18,6 @@
   new_client_id: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
   new_tenant_name: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
   resource_collection_enabled: true,
-  secretless_auth_enabled: true,
   tenant_name: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
 })
 p api_instance.update_azure_integration(body)

examples/v2/key-management/ValidateV2.rb

@@ -0,0 +1,8 @@
+# Validate API key returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.validate_v2".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::KeyManagementAPI.new
+p api_instance.validate_v2()