@thinkai/tai-api-contract 2.184.0 → 2.185.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.184.0
+  version: 2.185.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -6371,6 +6371,76 @@ paths:
               schema:
                 $ref: "#/components/schemas/GrafanaTriggerSyncResultDto"
 
+  /workspaces/{workspaceId}/integrations/datadog:
+    get:
+      tags: [Integrations]
+      summary: Datadog monitoring integration status
+      operationId: getWorkspaceDatadogIntegrationStatus
+      description: >
+        Returns whether Datadog is connected for the workspace (site + dual keys) and the last
+        monitoring ingest sync outcome (incidents/deployments pulled into Quality and DORA metrics).
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Datadog integration status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DatadogIntegrationStatusDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/integrations/datadog/sync:
+    post:
+      tags: [Integrations]
+      summary: Trigger Datadog monitoring ingest now
+      operationId: postWorkspaceDatadogIntegrationSync
+      description: >
+        Manually polls Datadog for incidents and deployment-tagged events, persists canonical
+        monitoring events, and refreshes org-level Quality/DORA dashboard buckets. Requires editor role.
+      security:
+        - bearerAuth: []
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Sync completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DatadogTriggerSyncResultDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Datadog is not connected on this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DatadogTriggerSyncResultDto"
+        "503":
+          description: Sync failed (Datadog API or persistence error)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DatadogTriggerSyncResultDto"
+
   /integrations/github/webhook:
     post:
       tags: [Integrations]
@@ -19374,6 +19444,80 @@ components:
         error:
           type: string
 
+    DatadogIntegrationStatusDto:
+      type: object
+      additionalProperties: false
+      required: [connected, status]
+      properties:
+        connected:
+          type: boolean
+          description: "True when a type:datadog workspace source is configured."
+        site:
+          type: string
+          enum:
+            - datadoghq.com
+            - us3.datadoghq.com
+            - us5.datadoghq.com
+            - datadoghq.eu
+            - ap1.datadoghq.com
+          description: Configured Datadog site when connected.
+        orgName:
+          type: string
+          description: Org display name when known from the last successful verify.
+        lastSyncAt:
+          type: string
+          format: date-time
+          nullable: true
+          description: Timestamp of the last monitoring ingest attempt (success or failure).
+        status:
+          type: string
+          enum: [ok, error, never]
+          description: Outcome of the most recent sync (`never` when not yet synced).
+        lastError:
+          type: string
+          nullable: true
+        issueCount:
+          type: integer
+          nullable: true
+          description: Incidents fetched on the last successful sync (30d lookback).
+        deploymentCount:
+          type: integer
+          nullable: true
+          description: Deployment-tagged events fetched on the last successful sync (30d lookback).
+        eventCount:
+          type: integer
+          nullable: true
+          description: Canonical monitoring events upserted on the last successful sync.
+
+    DatadogTriggerSyncResultDto:
+      type: object
+      additionalProperties: false
+      required: [status]
+      properties:
+        status:
+          type: string
+          enum: [ok, skipped, error]
+        code:
+          type: string
+          description: Stable machine-readable code (e.g. `datadog_not_connected`).
+        reason:
+          type: string
+          description: Human-readable skip reason when status is skipped.
+        issueCount:
+          type: integer
+        deploymentCount:
+          type: integer
+        eventCount:
+          type: integer
+        bucketsWritten:
+          type: integer
+          description: Weekly dashboard metric buckets updated from monitoring events.
+        durationMs:
+          type: integer
+        error:
+          type: string
+          description: Error message when status is error.
+
     GithubActionsEnableResponseDto:
       type: object
       additionalProperties: false
@@ -23329,6 +23473,10 @@ components:
         - integrations.grafana.removed
         - integrations.grafana.sync_completed
         - integrations.grafana.sync_failed
+        - integrations.datadog.added
+        - integrations.datadog.removed
+        - integrations.datadog.sync_completed
+        - integrations.datadog.sync_failed
         - integrations.zelt.added
         - integrations.zelt.removed
         - report.exported
@@ -23739,7 +23887,7 @@ components:
       properties:
         version:
           type: string
-          enum: ["2026-10-24.1"]
+          enum: ["2026-10-25.1"]
         periodDays:
           type: integer
           enum: [90]
@@ -23825,12 +23973,12 @@ components:
                 enum: [jira]
             incident:
               type: array
-              minItems: 6
-              maxItems: 6
+              minItems: 7
+              maxItems: 7
               uniqueItems: true
               items:
                 type: string
-                enum: [pagerduty, opsgenie, goalert, newrelic, prometheus, grafana]
+                enum: [pagerduty, opsgenie, goalert, newrelic, prometheus, grafana, datadog]
         selfManagedGit:
           type: object
           additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.184.0",
+  "version": "2.185.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -2227,6 +2227,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/datadog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Datadog monitoring integration status
+         * @description Returns whether Datadog is connected for the workspace (site + dual keys) and the last monitoring ingest sync outcome (incidents/deployments pulled into Quality and DORA metrics).
+         */
+        get: operations["getWorkspaceDatadogIntegrationStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/datadog/sync": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger Datadog monitoring ingest now
+         * @description Manually polls Datadog for incidents and deployment-tagged events, persists canonical monitoring events, and refreshes org-level Quality/DORA dashboard buckets. Requires editor role.
+         */
+        post: operations["postWorkspaceDatadogIntegrationSync"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/integrations/github/webhook": {
         parameters: {
             query?: never;
@@ -7907,6 +7947,50 @@ export interface components {
             durationMs?: number;
             error?: string;
         };
+        DatadogIntegrationStatusDto: {
+            /** @description True when a type:datadog workspace source is configured. */
+            connected: boolean;
+            /**
+             * @description Configured Datadog site when connected.
+             * @enum {string}
+             */
+            site?: "datadoghq.com" | "us3.datadoghq.com" | "us5.datadoghq.com" | "datadoghq.eu" | "ap1.datadoghq.com";
+            /** @description Org display name when known from the last successful verify. */
+            orgName?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp of the last monitoring ingest attempt (success or failure).
+             */
+            lastSyncAt?: string | null;
+            /**
+             * @description Outcome of the most recent sync (`never` when not yet synced).
+             * @enum {string}
+             */
+            status: "ok" | "error" | "never";
+            lastError?: string | null;
+            /** @description Incidents fetched on the last successful sync (30d lookback). */
+            issueCount?: number | null;
+            /** @description Deployment-tagged events fetched on the last successful sync (30d lookback). */
+            deploymentCount?: number | null;
+            /** @description Canonical monitoring events upserted on the last successful sync. */
+            eventCount?: number | null;
+        };
+        DatadogTriggerSyncResultDto: {
+            /** @enum {string} */
+            status: "ok" | "skipped" | "error";
+            /** @description Stable machine-readable code (e.g. `datadog_not_connected`). */
+            code?: string;
+            /** @description Human-readable skip reason when status is skipped. */
+            reason?: string;
+            issueCount?: number;
+            deploymentCount?: number;
+            eventCount?: number;
+            /** @description Weekly dashboard metric buckets updated from monitoring events. */
+            bucketsWritten?: number;
+            durationMs?: number;
+            /** @description Error message when status is error. */
+            error?: string;
+        };
         GithubActionsEnableResponseDto: {
             /** @enum {string} */
             outcome: "enabled" | "needs_github" | "permissions_missing" | "error";
@@ -9602,7 +9686,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.datadog.added" | "integrations.datadog.removed" | "integrations.datadog.sync_completed" | "integrations.datadog.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
         /** @description Current legal-approved opt-in notice, or `unset` while opt-in is unavailable. */
         AggregateUseNoticeStatusDto: {
             /** @enum {string} */
@@ -9765,7 +9849,7 @@ export interface components {
         };
         AssessmentDictionaryDto: {
             /** @enum {string} */
-            version: "2026-10-24.1";
+            version: "2026-10-25.1";
             /** @enum {integer} */
             periodDays: 90;
             /** @enum {integer} */
@@ -9801,7 +9885,7 @@ export interface components {
             aiProviders: ("cursor" | "claude" | "copilot")[];
             optionalProviders: {
                 roadmap: "jira"[];
-                incident: ("pagerduty" | "opsgenie" | "goalert" | "newrelic" | "prometheus" | "grafana")[];
+                incident: ("pagerduty" | "opsgenie" | "goalert" | "newrelic" | "prometheus" | "grafana" | "datadog")[];
             };
             selfManagedGit: {
                 /** @enum {string} */
@@ -12753,6 +12837,8 @@ export type PrometheusIntegrationStatusDto = components['schemas']['PrometheusIn
 export type PrometheusTriggerSyncResultDto = components['schemas']['PrometheusTriggerSyncResultDto'];
 export type GrafanaIntegrationStatusDto = components['schemas']['GrafanaIntegrationStatusDto'];
 export type GrafanaTriggerSyncResultDto = components['schemas']['GrafanaTriggerSyncResultDto'];
+export type DatadogIntegrationStatusDto = components['schemas']['DatadogIntegrationStatusDto'];
+export type DatadogTriggerSyncResultDto = components['schemas']['DatadogTriggerSyncResultDto'];
 export type GithubActionsEnableResponseDto = components['schemas']['GithubActionsEnableResponseDto'];
 export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
 export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
@@ -19407,6 +19493,90 @@ export interface operations {
             };
         };
     };
+    getWorkspaceDatadogIntegrationStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Datadog integration status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatadogIntegrationStatusDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    postWorkspaceDatadogIntegrationSync: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sync completed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatadogTriggerSyncResultDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Datadog is not connected on this workspace */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatadogTriggerSyncResultDto"];
+                };
+            };
+            /** @description Sync failed (Datadog API or persistence error) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatadogTriggerSyncResultDto"];
+                };
+            };
+        };
+    };
     postGithubWebhook: {
         parameters: {
             query?: never;