Update DORA API docs to allow timestamps in milliseconds and seconds (#1936)

Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-08-09 12:06:49.961468",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:42.589994",
+            "spec_repo_commit": "4a0f9e08"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-08-09 12:06:49.979811",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:42.608230",
+            "spec_repo_commit": "4a0f9e08"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -6396,8 +6396,9 @@ components:
           example: staging
           type: string
         finished_at:
-          description: Unix timestamp in nanoseconds when the deployment finished.
-            It should not be older than 1 hour.
+          description: Unix timestamp when the deployment finished. It must be in
+            nanoseconds, milliseconds, or seconds, and it should not be older than
+            1 hour.
           example: 1693491984000000000
           format: int64
           type: integer
@@ -6411,7 +6412,8 @@ components:
           example: shopist
           type: string
         started_at:
-          description: Unix timestamp in nanoseconds when the deployment started.
+          description: Unix timestamp when the deployment started. It must be in nanoseconds,
+            milliseconds, or seconds.
           example: 1693491974000000000
           format: int64
           type: integer
@@ -6488,8 +6490,8 @@ components:
           example: staging
           type: string
         finished_at:
-          description: Unix timestamp in nanoseconds when the incident finished. It
-            should not be older than 1 hour.
+          description: Unix timestamp when the incident finished. It must be in nanoseconds,
+            milliseconds, or seconds, and it should not be older than 1 hour.
           example: 1693491984000000000
           format: int64
           type: integer
@@ -6516,7 +6518,8 @@ components:
           example: High
           type: string
         started_at:
-          description: Unix timestamp in nanoseconds when the incident started.
+          description: Unix timestamp when the incident started. It must be in nanoseconds,
+            milliseconds, or seconds.
           example: 1693491974000000000
           format: int64
           type: integer

lib/datadog_api_client/v2/models/dora_deployment_request_attributes.rb

@@ -24,7 +24,7 @@ class DORADeploymentRequestAttributes
     # Environment name to where the service was deployed.
     attr_accessor :env
 
-    # Unix timestamp in nanoseconds when the deployment finished. It should not be older than 1 hour.
+    # Unix timestamp when the deployment finished. It must be in nanoseconds, milliseconds, or seconds, and it should not be older than 1 hour.
     attr_reader :finished_at
 
     # Git info for DORA Metrics events.
@@ -36,7 +36,7 @@ class DORADeploymentRequestAttributes
     # Service name from a service available in the Service Catalog.
     attr_reader :service
 
-    # Unix timestamp in nanoseconds when the deployment started.
+    # Unix timestamp when the deployment started. It must be in nanoseconds, milliseconds, or seconds.
     attr_reader :started_at
 
     # Version to correlate with [APM Deployment Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/).

lib/datadog_api_client/v2/models/dora_incident_request_attributes.rb

@@ -24,7 +24,7 @@ class DORAIncidentRequestAttributes
     # Environment name that was impacted by the incident.
     attr_accessor :env
 
-    # Unix timestamp in nanoseconds when the incident finished. It should not be older than 1 hour.
+    # Unix timestamp when the incident finished. It must be in nanoseconds, milliseconds, or seconds, and it should not be older than 1 hour.
     attr_accessor :finished_at
 
     # Git info for DORA Metrics events.
@@ -42,7 +42,7 @@ class DORAIncidentRequestAttributes
     # Incident severity.
     attr_accessor :severity
 
-    # Unix timestamp in nanoseconds when the incident started.
+    # Unix timestamp when the incident started. It must be in nanoseconds, milliseconds, or seconds.
     attr_reader :started_at
 
     # Name of the team owning the services impacted. If possible, use team handles registered in Datadog. Required when the services field is not provided.