Update DORA endpoints (#2591)

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:37.993718",
-            "spec_repo_commit": "38b3c05a"
+            "regenerated": "2025-06-05 08:11:21.207273",
+            "spec_repo_commit": "0e7259ca"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-04 17:40:38.008535",
-            "spec_repo_commit": "38b3c05a"
+            "regenerated": "2025-06-05 08:11:21.224587",
+            "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.

docs/datadog_api_client.v2.model.rst

@@ -4771,59 +4771,59 @@ datadog\_api\_client.v2.model.dora\_event module
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_fetch\_response module
-----------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_failure\_request module
+-----------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_fetch_response
+.. automodule:: datadog_api_client.v2.model.dora_failure_request
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_git\_info module
-----------------------------------------------------
+datadog\_api\_client.v2.model.dora\_failure\_request\_attributes module
+-----------------------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_git_info
+.. automodule:: datadog_api_client.v2.model.dora_failure_request_attributes
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_request module
-------------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_failure\_request\_data module
+-----------------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_request
+.. automodule:: datadog_api_client.v2.model.dora_failure_request_data
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_request\_attributes module
-------------------------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_failure\_response module
+------------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_request_attributes
+.. automodule:: datadog_api_client.v2.model.dora_failure_response
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_request\_data module
+datadog\_api\_client.v2.model.dora\_failure\_response\_data module
 ------------------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_request_data
+.. automodule:: datadog_api_client.v2.model.dora_failure_response_data
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_response module
--------------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_failure\_type module
+--------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_response
+.. automodule:: datadog_api_client.v2.model.dora_failure_type
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_response\_data module
--------------------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_fetch\_response module
+----------------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_response_data
+.. automodule:: datadog_api_client.v2.model.dora_fetch_response
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.dora\_incident\_type module
----------------------------------------------------------
+datadog\_api\_client.v2.model.dora\_git\_info module
+----------------------------------------------------
 
-.. automodule:: datadog_api_client.v2.model.dora_incident_type
+.. automodule:: datadog_api_client.v2.model.dora_git_info
    :members:
    :show-inheritance:
 

examples/v2/dora-metrics/CreateDORADeployment.py

@@ -25,7 +25,6 @@
 )
 
 configuration = Configuration()
-configuration.unstable_operations["create_dora_deployment"] = True
 with ApiClient(configuration) as api_client:
     api_instance = DORAMetricsApi(api_client)
     response = api_instance.create_dora_deployment(body=body)