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

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:46.968763",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:43.432822",
+            "spec_repo_commit": "4a0f9e08"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-08-09 12:06:46.987436",
-            "spec_repo_commit": "a21ba287"
+            "regenerated": "2024-08-09 16:10:43.451410",
+            "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

packages/datadog-api-client-v2/models/DORADeploymentRequestAttributes.ts

@@ -16,7 +16,7 @@ export class DORADeploymentRequestAttributes {
    */
   "env"?: string;
   /**
-   * 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.
    */
   "finishedAt": number;
   /**
@@ -32,7 +32,7 @@ export class DORADeploymentRequestAttributes {
    */
   "service": string;
   /**
-   * Unix timestamp in nanoseconds when the deployment started.
+   * Unix timestamp when the deployment started. It must be in nanoseconds, milliseconds, or seconds.
    */
   "startedAt": number;
   /**

packages/datadog-api-client-v2/models/DORAIncidentRequestAttributes.ts

@@ -16,7 +16,7 @@ export class DORAIncidentRequestAttributes {
    */
   "env"?: string;
   /**
-   * 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.
    */
   "finishedAt"?: number;
   /**
@@ -40,7 +40,7 @@ export class DORAIncidentRequestAttributes {
    */
   "severity"?: string;
   /**
-   * Unix timestamp in nanoseconds when the incident started.
+   * Unix timestamp when the incident started. It must be in nanoseconds, milliseconds, or seconds.
    */
   "startedAt": number;
   /**