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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
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:48.409820",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:46.744144",
+            "spec_repo_commit": "4a0f9e08"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-08-09 12:06:48.426734",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:46.762113",
+            "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

src/datadog_api_client/v2/model/dora_deployment_request_attributes.py

@@ -59,7 +59,7 @@ def __init__(
         :param env: Environment name to where the service was deployed.
         :type env: str, optional
 
-        :param finished_at: Unix timestamp in nanoseconds when the deployment finished. It should not be older than 1 hour.
+        :param finished_at: Unix timestamp when the deployment finished. It must be in nanoseconds, milliseconds, or seconds, and it should not be older than 1 hour.
         :type finished_at: int
 
         :param git: Git info for DORA Metrics events.
@@ -71,7 +71,7 @@ def __init__(
         :param service: Service name from a service available in the Service Catalog.
         :type service: str
 
-        :param started_at: Unix timestamp in nanoseconds when the deployment started.
+        :param started_at: Unix timestamp when the deployment started. It must be in nanoseconds, milliseconds, or seconds.
         :type started_at: int
 
         :param version: Version to correlate with `APM Deployment Tracking <https://docs.datadoghq.com/tracing/services/deployment_tracking/>`_.

src/datadog_api_client/v2/model/dora_incident_request_attributes.py

@@ -68,7 +68,7 @@ def __init__(
         :param env: Environment name that was impacted by the incident.
         :type env: str, optional
 
-        :param finished_at: Unix timestamp in nanoseconds when the incident finished. It should not be older than 1 hour.
+        :param finished_at: Unix timestamp when the incident finished. It must be in nanoseconds, milliseconds, or seconds, and it should not be older than 1 hour.
         :type finished_at: int, optional
 
         :param git: Git info for DORA Metrics events.
@@ -86,7 +86,7 @@ def __init__(
         :param severity: Incident severity.
         :type severity: str, optional
 
-        :param started_at: Unix timestamp in nanoseconds when the incident started.
+        :param started_at: Unix timestamp when the incident started. It must be in nanoseconds, milliseconds, or seconds.
         :type started_at: int
 
         :param team: Name of the team owning the services impacted. If possible, use team handles registered in Datadog. Required when the services field is not provided.