[SDCD-1826] Update DORA endpoints description and name (#3172)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit 090470486b7e · 2025-10-07T11:39:24.000Z
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -13717,8 +13717,7 @@ components:
           type: string
         finished_at:
           description: Unix timestamp when the deployment finished. It must be in
-            nanoseconds, milliseconds, or seconds, and it should not be older than
-            1 hour.
+            nanoseconds, milliseconds, or seconds.
           example: 1693491984000000000
           format: int64
           type: integer
@@ -57663,8 +57662,7 @@ paths:
         - manage_log_reports
   /api/v2/dora/deployment:
     post:
-      description: 'Use this API endpoint to provide data about deployments for DORA
-        metrics.
+      description: 'Use this API endpoint to provide deployment data.
 
 
         This is necessary for:
@@ -57706,7 +57704,7 @@ paths:
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
       - apiKeyAuth: []
-      summary: Send a deployment event for DORA Metrics
+      summary: Send a deployment event
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
@@ -57823,7 +57821,7 @@ paths:
         - dora_metrics_read
   /api/v2/dora/failure:
     post:
-      description: 'Use this API endpoint to provide failure data for DORA metrics.
+      description: 'Use this API endpoint to provide failure data.
 
 
         This is necessary for:
@@ -57863,7 +57861,7 @@ paths:
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
       - apiKeyAuth: []
-      summary: Send a failure event for DORA Metrics
+      summary: Send a failure event
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
@@ -57985,7 +57983,7 @@ paths:
         instead.
 
 
-        Use this API endpoint to provide failure data for DORA metrics.
+        Use this API endpoint to provide failure data.
 
 
         This is necessary for:
@@ -58025,7 +58023,7 @@ paths:
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
       - apiKeyAuth: []
-      summary: Send an incident event for DORA Metrics
+      summary: Send an incident event
       tags:
       - DORA Metrics
       x-codegen-request-body-name: body
diff --git a/examples/v2/dora-metrics/CreateDORADeployment.java b/examples/v2/dora-metrics/CreateDORADeployment.java
@@ -1,4 +1,4 @@
-// Send a deployment event for DORA Metrics returns "OK" response
+// Send a deployment event returns "OK" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
diff --git a/examples/v2/dora-metrics/CreateDORAFailure.java b/examples/v2/dora-metrics/CreateDORAFailure.java
@@ -1,4 +1,4 @@
-// Send a failure event for DORA Metrics returns "OK - but delayed due to incident" response
+// Send a failure event returns "OK - but delayed due to incident" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
diff --git a/examples/v2/dora-metrics/CreateDORAIncident.java b/examples/v2/dora-metrics/CreateDORAIncident.java
@@ -1,4 +1,4 @@
-// Send an incident event for DORA Metrics returns "OK" response
+// Send an incident event returns "OK" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
diff --git a/examples/v2/dora-metrics/CreateDORAIncident_1101664022.java b/examples/v2/dora-metrics/CreateDORAIncident_1101664022.java
@@ -1,4 +1,4 @@
-// Send a failure event for DORA Metrics returns "OK" response
+// Send a failure event returns "OK" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
diff --git a/src/main/java/com/datadog/api/client/v2/api/DoraMetricsApi.java b/src/main/java/com/datadog/api/client/v2/api/DoraMetricsApi.java
@@ -51,7 +51,7 @@ public void setApiClient(ApiClient apiClient) {
   }
 
   /**
-   * Send a deployment event for DORA Metrics.
+   * Send a deployment event.
    *
    * <p>See {@link #createDORADeploymentWithHttpInfo}.
    *
@@ -65,7 +65,7 @@ public DORADeploymentResponse createDORADeployment(DORADeploymentRequest body)
   }
 
   /**
-   * Send a deployment event for DORA Metrics.
+   * Send a deployment event.
    *
    * <p>See {@link #createDORADeploymentWithHttpInfoAsync}.
    *
@@ -82,7 +82,7 @@ public CompletableFuture<DORADeploymentResponse> createDORADeploymentAsync(
   }
 
   /**
-   * Use this API endpoint to provide data about deployments for DORA metrics.
+   * Use this API endpoint to provide deployment data.
    *
    * <p>This is necessary for: - Deployment Frequency - Change Lead Time - Change Failure Rate
    *
@@ -135,7 +135,7 @@ public ApiResponse<DORADeploymentResponse> createDORADeploymentWithHttpInfo(
   }
 
   /**
-   * Send a deployment event for DORA Metrics.
+   * Send a deployment event.
    *
    * <p>See {@link #createDORADeploymentWithHttpInfo}.
    *
@@ -187,7 +187,7 @@ public ApiResponse<DORADeploymentResponse> createDORADeploymentWithHttpInfo(
   }
 
   /**
-   * Send a failure event for DORA Metrics.
+   * Send a failure event.
    *
    * <p>See {@link #createDORAFailureWithHttpInfo}.
    *
@@ -200,7 +200,7 @@ public DORAFailureResponse createDORAFailure(DORAFailureRequest body) throws Api
   }
 
   /**
-   * Send a failure event for DORA Metrics.
+   * Send a failure event.
    *
    * <p>See {@link #createDORAFailureWithHttpInfoAsync}.
    *
@@ -216,7 +216,7 @@ public CompletableFuture<DORAFailureResponse> createDORAFailureAsync(DORAFailure
   }
 
   /**
-   * Use this API endpoint to provide failure data for DORA metrics.
+   * Use this API endpoint to provide failure data.
    *
    * <p>This is necessary for: - Change Failure Rate - Time to Restore
    *
@@ -269,7 +269,7 @@ public ApiResponse<DORAFailureResponse> createDORAFailureWithHttpInfo(DORAFailur
   }
 
   /**
-   * Send a failure event for DORA Metrics.
+   * Send a failure event.
    *
    * <p>See {@link #createDORAFailureWithHttpInfo}.
    *
@@ -321,7 +321,7 @@ public CompletableFuture<ApiResponse<DORAFailureResponse>> createDORAFailureWith
   }
 
   /**
-   * Send an incident event for DORA Metrics.
+   * Send an incident event.
    *
    * <p>See {@link #createDORAIncidentWithHttpInfo}.
    *
@@ -336,7 +336,7 @@ public DORAFailureResponse createDORAIncident(DORAFailureRequest body) throws Ap
   }
 
   /**
-   * Send an incident event for DORA Metrics.
+   * Send an incident event.
    *
    * <p>See {@link #createDORAIncidentWithHttpInfoAsync}.
    *
@@ -357,7 +357,7 @@ public CompletableFuture<DORAFailureResponse> createDORAIncidentAsync(DORAFailur
    * <strong>Note</strong>: This endpoint is deprecated. Please use <code>/api/v2/dora/failure
    * </code> instead.
    *
-   * <p>Use this API endpoint to provide failure data for DORA metrics.
+   * <p>Use this API endpoint to provide failure data.
    *
    * <p>This is necessary for: - Change Failure Rate - Time to Restore
    *
@@ -413,7 +413,7 @@ public ApiResponse<DORAFailureResponse> createDORAIncidentWithHttpInfo(DORAFailu
   }
 
   /**
-   * Send an incident event for DORA Metrics.
+   * Send an incident event.
    *
    * <p>See {@link #createDORAIncidentWithHttpInfo}.
    *
diff --git a/src/main/java/com/datadog/api/client/v2/model/DORADeploymentRequestAttributes.java b/src/main/java/com/datadog/api/client/v2/model/DORADeploymentRequestAttributes.java
@@ -147,7 +147,7 @@ public DORADeploymentRequestAttributes finishedAt(Long finishedAt) {
 
   /**
    * Unix timestamp when the deployment finished. It must be in nanoseconds, milliseconds, or
-   * seconds, and it should not be older than 1 hour.
+   * seconds.
    *
    * @return finishedAt
    */
diff --git a/src/test/resources/cassettes/features/v2/Send_a_deployment_event_returns_OK_response.freeze b/src/test/resources/cassettes/features/v2/Send_a_deployment_event_returns_OK_response.freeze
diff --git a/src/test/resources/cassettes/features/v2/Send_a_deployment_event_returns_OK_response.json b/src/test/resources/cassettes/features/v2/Send_a_deployment_event_returns_OK_response.json
diff --git a/src/test/resources/cassettes/features/v2/Send_a_failure_event_returns_OK_response.freeze b/src/test/resources/cassettes/features/v2/Send_a_failure_event_returns_OK_response.freeze
diff --git a/src/test/resources/cassettes/features/v2/Send_a_failure_event_returns_OK_response.json b/src/test/resources/cassettes/features/v2/Send_a_failure_event_returns_OK_response.json
diff --git a/src/test/resources/com/datadog/api/client/v2/api/dora_metrics.feature b/src/test/resources/com/datadog/api/client/v2/api/dora_metrics.feature
@@ -105,63 +105,63 @@ Feature: DORA Metrics
     Then the response status is 200 OK
 
   @skip @team:DataDog/ci-app-backend
-  Scenario: Send a deployment event for DORA Metrics returns "Bad Request" response
+  Scenario: Send a deployment event returns "Bad Request" response
     Given new "CreateDORADeployment" request
     And body with value {"data": {"attributes": {}}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/ci-app-backend
-  Scenario: Send a deployment event for DORA Metrics returns "OK - but delayed due to incident" response
+  Scenario: Send a deployment event returns "OK - but delayed due to incident" response
     Given new "CreateDORADeployment" request
     And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "service": "shopist", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
   @replay-only @team:DataDog/ci-app-backend
-  Scenario: Send a deployment event for DORA Metrics returns "OK" response
+  Scenario: Send a deployment event returns "OK" response
     Given new "CreateDORADeployment" request
     And body with value {"data": {"attributes": {"finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "service": "shopist", "started_at": 1693491974000000000, "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 200 OK
 
   @skip @team:DataDog/ci-app-backend
-  Scenario: Send a failure event for DORA Metrics returns "Bad Request" response
+  Scenario: Send a failure event returns "Bad Request" response
     Given new "CreateDORAIncident" request
     And body with value {"data": {"attributes": {}}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/ci-app-backend
-  Scenario: Send a failure event for DORA Metrics returns "OK - but delayed due to incident" response
+  Scenario: Send a failure event returns "OK - but delayed due to incident" response
     Given new "CreateDORAFailure" request
     And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
   @replay-only @team:DataDog/ci-app-backend
-  Scenario: Send a failure event for DORA Metrics returns "OK" response
+  Scenario: Send a failure event returns "OK" response
     Given new "CreateDORAIncident" request
     And body with value {"data": {"attributes": {"finished_at": 1707842944600000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests", "services": ["shopist"], "severity": "High", "started_at": 1707842944500000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 200 OK
 
   @generated @skip @team:DataDog/ci-app-backend
-  Scenario: Send an incident event for DORA Metrics returns "Bad Request" response
+  Scenario: Send an incident event returns "Bad Request" response
     Given new "CreateDORAIncident" request
     And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/ci-app-backend
-  Scenario: Send an incident event for DORA Metrics returns "OK - but delayed due to incident" response
+  Scenario: Send an incident event returns "OK - but delayed due to incident" response
     Given new "CreateDORAIncident" request
     And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
   @generated @skip @team:DataDog/ci-app-backend
-  Scenario: Send an incident event for DORA Metrics returns "OK" response
+  Scenario: Send an incident event returns "OK" response
     Given new "CreateDORAIncident" request
     And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Send a deployment event for DORA Metrics returns "OK" response`
	`1`	`+// Send a deployment event returns "OK" response`
`2`	`2`
`3`	`3`	`import com.datadog.api.client.ApiClient;`
`4`	`4`	`import com.datadog.api.client.ApiException;`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Send a failure event for DORA Metrics returns "OK - but delayed due to incident" response`
	`1`	`+// Send a failure event returns "OK - but delayed due to incident" response`
`2`	`2`
`3`	`3`	`import com.datadog.api.client.ApiClient;`
`4`	`4`	`import com.datadog.api.client.ApiException;`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Send an incident event for DORA Metrics returns "OK" response`
	`1`	`+// Send an incident event returns "OK" response`
`2`	`2`
`3`	`3`	`import com.datadog.api.client.ApiClient;`
`4`	`4`	`import com.datadog.api.client.ApiException;`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Send a failure event for DORA Metrics returns "OK" response`
	`1`	`+// Send a failure event returns "OK" response`
`2`	`2`
`3`	`3`	`import com.datadog.api.client.ApiClient;`
`4`	`4`	`import com.datadog.api.client.ApiException;`
Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,7 @@ public void setApiClient(ApiClient apiClient) {`
`51`	`51`	`}`
`52`	`52`
`53`	`53`	`/**`
`54`		`- * Send a deployment event for DORA Metrics.`
	`54`	`+ * Send a deployment event.`
`55`	`55`	`*`
`56`	`56`	`* <p>See {@link #createDORADeploymentWithHttpInfo}.`
`57`	`57`	`*`
`@@ -65,7 +65,7 @@ public DORADeploymentResponse createDORADeployment(DORADeploymentRequest body)`
`65`	`65`	`}`
`66`	`66`
`67`	`67`	`/**`
`68`		`- * Send a deployment event for DORA Metrics.`
	`68`	`+ * Send a deployment event.`
`69`	`69`	`*`
`70`	`70`	`* <p>See {@link #createDORADeploymentWithHttpInfoAsync}.`
`71`	`71`	`*`
`@@ -82,7 +82,7 @@ public CompletableFuture<DORADeploymentResponse> createDORADeploymentAsync(`
`82`	`82`	`}`
`83`	`83`
`84`	`84`	`/**`
`85`		`- * Use this API endpoint to provide data about deployments for DORA metrics.`
	`85`	`+ * Use this API endpoint to provide deployment data.`
`86`	`86`	`*`
`87`	`87`	`* <p>This is necessary for: - Deployment Frequency - Change Lead Time - Change Failure Rate`
`88`	`88`	`*`
`@@ -135,7 +135,7 @@ public ApiResponse<DORADeploymentResponse> createDORADeploymentWithHttpInfo(`
`135`	`135`	`}`
`136`	`136`
`137`	`137`	`/**`
`138`		`- * Send a deployment event for DORA Metrics.`
	`138`	`+ * Send a deployment event.`
`139`	`139`	`*`
`140`	`140`	`* <p>See {@link #createDORADeploymentWithHttpInfo}.`
`141`	`141`	`*`
`@@ -187,7 +187,7 @@ public ApiResponse<DORADeploymentResponse> createDORADeploymentWithHttpInfo(`
`187`	`187`	`}`
`188`	`188`
`189`	`189`	`/**`
`190`		`- * Send a failure event for DORA Metrics.`
	`190`	`+ * Send a failure event.`
`191`	`191`	`*`
`192`	`192`	`* <p>See {@link #createDORAFailureWithHttpInfo}.`
`193`	`193`	`*`
`@@ -200,7 +200,7 @@ public DORAFailureResponse createDORAFailure(DORAFailureRequest body) throws Api`
`200`	`200`	`}`
`201`	`201`
`202`	`202`	`/**`
`203`		`- * Send a failure event for DORA Metrics.`
	`203`	`+ * Send a failure event.`
`204`	`204`	`*`
`205`	`205`	`* <p>See {@link #createDORAFailureWithHttpInfoAsync}.`
`206`	`206`	`*`
`@@ -216,7 +216,7 @@ public CompletableFuture<DORAFailureResponse> createDORAFailureAsync(DORAFailure`
`216`	`216`	`}`
`217`	`217`
`218`	`218`	`/**`
`219`		`- * Use this API endpoint to provide failure data for DORA metrics.`
	`219`	`+ * Use this API endpoint to provide failure data.`
`220`	`220`	`*`
`221`	`221`	`* <p>This is necessary for: - Change Failure Rate - Time to Restore`
`222`	`222`	`*`
`@@ -269,7 +269,7 @@ public ApiResponse<DORAFailureResponse> createDORAFailureWithHttpInfo(DORAFailur`
`269`	`269`	`}`
`270`	`270`
`271`	`271`	`/**`
`272`		`- * Send a failure event for DORA Metrics.`
	`272`	`+ * Send a failure event.`
`273`	`273`	`*`
`274`	`274`	`* <p>See {@link #createDORAFailureWithHttpInfo}.`
`275`	`275`	`*`
`@@ -321,7 +321,7 @@ public CompletableFuture<ApiResponse<DORAFailureResponse>> createDORAFailureWith`
`321`	`321`	`}`
`322`	`322`
`323`	`323`	`/**`
`324`		`- * Send an incident event for DORA Metrics.`
	`324`	`+ * Send an incident event.`
`325`	`325`	`*`
`326`	`326`	`* <p>See {@link #createDORAIncidentWithHttpInfo}.`
`327`	`327`	`*`
`@@ -336,7 +336,7 @@ public DORAFailureResponse createDORAIncident(DORAFailureRequest body) throws Ap`
`336`	`336`	`}`
`337`	`337`
`338`	`338`	`/**`
`339`		`- * Send an incident event for DORA Metrics.`
	`339`	`+ * Send an incident event.`
`340`	`340`	`*`
`341`	`341`	`* <p>See {@link #createDORAIncidentWithHttpInfoAsync}.`
`342`	`342`	`*`
`@@ -357,7 +357,7 @@ public CompletableFuture<DORAFailureResponse> createDORAIncidentAsync(DORAFailur`
`357`	`357`	`* <strong>Note</strong>: This endpoint is deprecated. Please use <code>/api/v2/dora/failure`
`358`	`358`	`* </code> instead.`
`359`	`359`	`*`
`360`		`- * <p>Use this API endpoint to provide failure data for DORA metrics.`
	`360`	`+ * <p>Use this API endpoint to provide failure data.`
`361`	`361`	`*`
`362`	`362`	`* <p>This is necessary for: - Change Failure Rate - Time to Restore`
`363`	`363`	`*`
`@@ -413,7 +413,7 @@ public ApiResponse<DORAFailureResponse> createDORAIncidentWithHttpInfo(DORAFailu`
`413`	`413`	`}`
`414`	`414`
`415`	`415`	`/**`
`416`		`- * Send an incident event for DORA Metrics.`
	`416`	`+ * Send an incident event.`
`417`	`417`	`*`
`418`	`418`	`* <p>See {@link #createDORAIncidentWithHttpInfo}.`
`419`	`419`	`*`
Original file line number	Diff line number	Diff line change
`@@ -147,7 +147,7 @@ public DORADeploymentRequestAttributes finishedAt(Long finishedAt) {`
`147`	`147`
`148`	`148`	`/**`
`149`	`149`	`* Unix timestamp when the deployment finished. It must be in nanoseconds, milliseconds, or`
`150`		`- * seconds, and it should not be older than 1 hour.`
	`150`	`+ * seconds.`
`151`	`151`	`*`
`152`	`152`	`* @return finishedAt`
`153`	`153`	`*/`