Regenerate client from commit 680f743e of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-27 17:12:14.968856",
-            "spec_repo_commit": "ed439f7c"
+            "regenerated": "2025-05-30 10:26:20.012254",
+            "spec_repo_commit": "680f743e"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-27 17:12:14.988382",
-            "spec_repo_commit": "ed439f7c"
+            "regenerated": "2025-05-30 10:26:20.028007",
+            "spec_repo_commit": "680f743e"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -11096,56 +11096,39 @@ components:
           description: The type of the event.
           type: string
       type: object
-    DORAFetchResponse:
-      description: Response for the DORA fetch endpoints.
-      properties:
-        data:
-          $ref: '#/components/schemas/DORAEvent'
-      type: object
-    DORAGitInfo:
-      description: Git info for DORA Metrics events.
-      properties:
-        commit_sha:
-          $ref: '#/components/schemas/GitCommitSHA'
-        repository_url:
-          $ref: '#/components/schemas/GitRepositoryURL'
-      required:
-      - repository_url
-      - commit_sha
-      type: object
-    DORAIncidentRequest:
-      description: Request to create a DORA incident event.
+    DORAFailureRequest:
+      description: Request to create a DORA failure event.
       properties:
         data:
-          $ref: '#/components/schemas/DORAIncidentRequestData'
+          $ref: '#/components/schemas/DORAFailureRequestData'
       required:
       - data
       type: object
-    DORAIncidentRequestAttributes:
-      description: Attributes to create a DORA incident event.
+    DORAFailureRequestAttributes:
+      description: Attributes to create a DORA failure event.
       properties:
         env:
-          description: Environment name that was impacted by the incident.
+          description: Environment name that was impacted by the failure.
           example: staging
           type: string
         finished_at:
-          description: Unix timestamp when the incident finished. It must be in nanoseconds,
+          description: Unix timestamp when the failure finished. It must be in nanoseconds,
             milliseconds, or seconds, and it should not be older than 1 hour.
           example: 1693491984000000000
           format: int64
           type: integer
         git:
           $ref: '#/components/schemas/DORAGitInfo'
         id:
-          description: Incident ID. Must have at least 16 characters. Required to
-            update a previously sent incident.
+          description: Failure ID. Must have at least 16 characters. Required to update
+            a previously sent failure.
           type: string
         name:
-          description: Incident name.
+          description: Failure name.
           example: Webserver is down failing all requests.
           type: string
         services:
-          description: Service names impacted by the incident. If possible, use names
+          description: Service names impacted by the failure. If possible, use names
             registered in the Service Catalog. Required when the team field is not
             provided.
           example:
@@ -11154,11 +11137,11 @@ components:
             type: string
           type: array
         severity:
-          description: Incident severity.
+          description: Failure severity.
           example: High
           type: string
         started_at:
-          description: Unix timestamp when the incident started. It must be in nanoseconds,
+          description: Unix timestamp when the failure started. It must be in nanoseconds,
             milliseconds, or seconds.
           example: 1693491974000000000
           format: int64
@@ -11176,43 +11159,60 @@ components:
       required:
       - started_at
       type: object
-    DORAIncidentRequestData:
+    DORAFailureRequestData:
       description: The JSON:API data.
       properties:
         attributes:
-          $ref: '#/components/schemas/DORAIncidentRequestAttributes'
+          $ref: '#/components/schemas/DORAFailureRequestAttributes'
       required:
       - attributes
       type: object
-    DORAIncidentResponse:
-      description: Response after receiving a DORA incident event.
+    DORAFailureResponse:
+      description: Response after receiving a DORA failure event.
       properties:
         data:
-          $ref: '#/components/schemas/DORAIncidentResponseData'
+          $ref: '#/components/schemas/DORAFailureResponseData'
       required:
       - data
       type: object
-    DORAIncidentResponseData:
-      description: Response after receiving a DORA incident event.
+    DORAFailureResponseData:
+      description: Response after receiving a DORA failure event.
       properties:
         id:
-          description: The ID of the received DORA incident event.
+          description: The ID of the received DORA failure event.
           example: 4242fcdd31586083
           type: string
         type:
-          $ref: '#/components/schemas/DORAIncidentType'
+          $ref: '#/components/schemas/DORAFailureType'
       required:
       - id
       type: object
-    DORAIncidentType:
-      default: dora_incident
-      description: JSON:API type for DORA incident events.
+    DORAFailureType:
+      default: dora_failure
+      description: JSON:API type for DORA failure events.
       enum:
-      - dora_incident
-      example: dora_incident
+      - dora_failure
+      example: dora_failure
       type: string
       x-enum-varnames:
-      - DORA_INCIDENT
+      - DORA_FAILURE
+    DORAFetchResponse:
+      description: Response for the DORA fetch endpoints.
+      properties:
+        data:
+          $ref: '#/components/schemas/DORAEvent'
+      type: object
+    DORAGitInfo:
+      description: Git info for DORA Metrics events.
+      properties:
+        commit_sha:
+          $ref: '#/components/schemas/GitCommitSHA'
+        repository_url:
+          $ref: '#/components/schemas/GitRepositoryURL'
+      required:
+      - repository_url
+      - commit_sha
+      type: object
     DORAListDeploymentsRequest:
       description: Request to get a list of deployments.
       properties:
@@ -45794,9 +45794,6 @@ paths:
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/dora/deployments:
     post:
       description: Use this API endpoint to get a list of deployment events.
@@ -45874,6 +45871,52 @@ paths:
         operator: OR
         permissions:
         - dora_metrics_read
+  /api/v2/dora/failure:
+    post:
+      description: 'Use this API endpoint to provide failure data for DORA metrics.
+
+
+        This is necessary for:
+
+        - Change Failure Rate
+
+        - Time to Restore'
+      operationId: CreateDORAFailure
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DORAFailureRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DORAFailureResponse'
+          description: OK
+        '202':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DORAFailureResponse'
+          description: OK - but delayed due to incident
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad Request
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+      summary: Send a failure event for DORA Metrics
+      tags:
+      - DORA Metrics
+      x-codegen-request-body-name: body
   /api/v2/dora/failures:
     post:
       description: Use this API endpoint to get a list of failure events.
@@ -45953,7 +45996,12 @@ paths:
         - dora_metrics_read
   /api/v2/dora/incident:
     post:
-      description: 'Use this API endpoint to provide failure data for DORA metrics.
+      deprecated: true
+      description: '**Note**: This endpoint is deprecated. Please use `/api/v2/dora/failure`
+        instead.
+
+
+        Use this API endpoint to provide failure data for DORA metrics.
 
 
         This is necessary for:
@@ -45966,20 +46014,20 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/DORAIncidentRequest'
+              $ref: '#/components/schemas/DORAFailureRequest'
         required: true
       responses:
         '200':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DORAIncidentResponse'
+                $ref: '#/components/schemas/DORAFailureResponse'
           description: OK
         '202':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DORAIncidentResponse'
+                $ref: '#/components/schemas/DORAFailureResponse'
           description: OK - but delayed due to incident
         '400':
           content:
@@ -45997,9 +46045,6 @@ paths:
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/downtime:
     get:
       description: Get all scheduled downtimes.

examples/v2/dora-metrics/CreateDORADeployment.java

@@ -12,7 +12,6 @@
 public class Example {
   public static void main(String[] args) {
     ApiClient defaultClient = ApiClient.getDefaultApiClient();
-    defaultClient.setUnstableOperationEnabled("v2.createDORADeployment", true);
     DoraMetricsApi apiInstance = new DoraMetricsApi(defaultClient);
 
     DORADeploymentRequest body =

examples/v2/dora-metrics/CreateDORAFailure.java

@@ -0,0 +1,49 @@
+// Send a failure event for DORA Metrics returns "OK - but delayed due to incident" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.DoraMetricsApi;
+import com.datadog.api.client.v2.model.DORAFailureRequest;
+import com.datadog.api.client.v2.model.DORAFailureRequestAttributes;
+import com.datadog.api.client.v2.model.DORAFailureRequestData;
+import com.datadog.api.client.v2.model.DORAFailureResponse;
+import com.datadog.api.client.v2.model.DORAGitInfo;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    DoraMetricsApi apiInstance = new DoraMetricsApi(defaultClient);
+
+    DORAFailureRequest body =
+        new DORAFailureRequest()
+            .data(
+                new DORAFailureRequestData()
+                    .attributes(
+                        new DORAFailureRequestAttributes()
+                            .env("staging")
+                            .finishedAt(1693491984000000000L)
+                            .git(
+                                new DORAGitInfo()
+                                    .commitSha("66adc9350f2cc9b250b69abddab733dd55e1a588")
+                                    .repositoryUrl(
+                                        "https://github.com/organization/example-repository"))
+                            .name("Webserver is down failing all requests.")
+                            .services(Collections.singletonList("shopist"))
+                            .severity("High")
+                            .startedAt(1693491974000000000L)
+                            .team("backend")
+                            .version("v1.12.07")));
+
+    try {
+      DORAFailureResponse result = apiInstance.createDORAFailure(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling DoraMetricsApi#createDORAFailure");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/dora-metrics/CreateDORAIncident.java

@@ -3,40 +3,40 @@
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
 import com.datadog.api.client.v2.api.DoraMetricsApi;
+import com.datadog.api.client.v2.model.DORAFailureRequest;
+import com.datadog.api.client.v2.model.DORAFailureRequestAttributes;
+import com.datadog.api.client.v2.model.DORAFailureRequestData;
+import com.datadog.api.client.v2.model.DORAFailureResponse;
 import com.datadog.api.client.v2.model.DORAGitInfo;
-import com.datadog.api.client.v2.model.DORAIncidentRequest;
-import com.datadog.api.client.v2.model.DORAIncidentRequestAttributes;
-import com.datadog.api.client.v2.model.DORAIncidentRequestData;
-import com.datadog.api.client.v2.model.DORAIncidentResponse;
 import java.util.Collections;
 
 public class Example {
   public static void main(String[] args) {
     ApiClient defaultClient = ApiClient.getDefaultApiClient();
-    defaultClient.setUnstableOperationEnabled("v2.createDORAIncident", true);
     DoraMetricsApi apiInstance = new DoraMetricsApi(defaultClient);
 
-    DORAIncidentRequest body =
-        new DORAIncidentRequest()
+    DORAFailureRequest body =
+        new DORAFailureRequest()
             .data(
-                new DORAIncidentRequestData()
+                new DORAFailureRequestData()
                     .attributes(
-                        new DORAIncidentRequestAttributes()
-                            .finishedAt(1707842944600000000L)
+                        new DORAFailureRequestAttributes()
+                            .env("staging")
+                            .finishedAt(1693491984000000000L)
                             .git(
                                 new DORAGitInfo()
                                     .commitSha("66adc9350f2cc9b250b69abddab733dd55e1a588")
                                     .repositoryUrl(
                                         "https://github.com/organization/example-repository"))
-                            .name("Webserver is down failing all requests")
+                            .name("Webserver is down failing all requests.")
                             .services(Collections.singletonList("shopist"))
                             .severity("High")
-                            .startedAt(1707842944500000000L)
+                            .startedAt(1693491974000000000L)
                             .team("backend")
                             .version("v1.12.07")));
 
     try {
-      DORAIncidentResponse result = apiInstance.createDORAIncident(body);
+      DORAFailureResponse result = apiInstance.createDORAIncident(body);
       System.out.println(result);
     } catch (ApiException e) {
       System.err.println("Exception when calling DoraMetricsApi#createDORAIncident");