Update DORA endpoints (#682)

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

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-04 17:40:40.467497",
-            "spec_repo_commit": "38b3c05a"
+            "regenerated": "2025-06-05 08:11:20.110994",
+            "spec_repo_commit": "0e7259ca"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-04 17:40:40.483266",
-            "spec_repo_commit": "38b3c05a"
+            "regenerated": "2025-06-05 08:11:20.126935",
+            "spec_repo_commit": "0e7259ca"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -11189,56 +11189,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:
@@ -11247,11 +11230,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
@@ -11269,43 +11252,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:
@@ -46094,9 +46094,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.
@@ -46174,6 +46171,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.
@@ -46253,7 +46296,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:
@@ -46266,20 +46314,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:
@@ -46297,9 +46345,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.rs

@@ -20,8 +20,7 @@ async fn main() {
         ))
         .version("v1.12.07".to_string()),
     ));
-    let mut configuration = datadog::Configuration::new();
-    configuration.set_unstable_operation_enabled("v2.CreateDORADeployment", true);
+    let configuration = datadog::Configuration::new();
     let api = DORAMetricsAPI::with_config(configuration);
     let resp = api.create_dora_deployment(body).await;
     if let Ok(value) = resp {

examples/v2_dora-metrics_CreateDORAFailure.rs

@@ -0,0 +1,34 @@
+// Send a failure event for DORA Metrics returns "OK - but delayed due to
+// incident" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_dora_metrics::DORAMetricsAPI;
+use datadog_api_client::datadogV2::model::DORAFailureRequest;
+use datadog_api_client::datadogV2::model::DORAFailureRequestAttributes;
+use datadog_api_client::datadogV2::model::DORAFailureRequestData;
+use datadog_api_client::datadogV2::model::DORAGitInfo;
+
+#[tokio::main]
+async fn main() {
+    let body = DORAFailureRequest::new(DORAFailureRequestData::new(
+        DORAFailureRequestAttributes::new(1693491974000000000)
+            .env("staging".to_string())
+            .finished_at(1693491984000000000)
+            .git(DORAGitInfo::new(
+                "66adc9350f2cc9b250b69abddab733dd55e1a588".to_string(),
+                "https://github.com/organization/example-repository".to_string(),
+            ))
+            .name("Webserver is down failing all requests.".to_string())
+            .services(vec!["shopist".to_string()])
+            .severity("High".to_string())
+            .team("backend".to_string())
+            .version("v1.12.07".to_string()),
+    ));
+    let configuration = datadog::Configuration::new();
+    let api = DORAMetricsAPI::with_config(configuration);
+    let resp = api.create_dora_failure(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_dora-metrics_CreateDORAIncident.rs

@@ -1,28 +1,28 @@
 // Send an incident event for DORA Metrics returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_dora_metrics::DORAMetricsAPI;
+use datadog_api_client::datadogV2::model::DORAFailureRequest;
+use datadog_api_client::datadogV2::model::DORAFailureRequestAttributes;
+use datadog_api_client::datadogV2::model::DORAFailureRequestData;
 use datadog_api_client::datadogV2::model::DORAGitInfo;
-use datadog_api_client::datadogV2::model::DORAIncidentRequest;
-use datadog_api_client::datadogV2::model::DORAIncidentRequestAttributes;
-use datadog_api_client::datadogV2::model::DORAIncidentRequestData;
 
 #[tokio::main]
 async fn main() {
-    let body = DORAIncidentRequest::new(DORAIncidentRequestData::new(
-        DORAIncidentRequestAttributes::new(1707842944500000000)
-            .finished_at(1707842944600000000)
+    let body = DORAFailureRequest::new(DORAFailureRequestData::new(
+        DORAFailureRequestAttributes::new(1693491974000000000)
+            .env("staging".to_string())
+            .finished_at(1693491984000000000)
             .git(DORAGitInfo::new(
                 "66adc9350f2cc9b250b69abddab733dd55e1a588".to_string(),
                 "https://github.com/organization/example-repository".to_string(),
             ))
-            .name("Webserver is down failing all requests".to_string())
+            .name("Webserver is down failing all requests.".to_string())
             .services(vec!["shopist".to_string()])
             .severity("High".to_string())
             .team("backend".to_string())
             .version("v1.12.07".to_string()),
     ));
-    let mut configuration = datadog::Configuration::new();
-    configuration.set_unstable_operation_enabled("v2.CreateDORAIncident", true);
+    let configuration = datadog::Configuration::new();
     let api = DORAMetricsAPI::with_config(configuration);
     let resp = api.create_dora_incident(body).await;
     if let Ok(value) = resp {