@thinkai/tai-api-contract 2.42.0 → 2.44.0

package/dist/generated/openapi.d.ts

@@ -445,6 +445,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/persons/{personId}/erase": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Erase person-level insights data (workspace admin)
+         * @description Workspace admin only. Deletes or anonymizes a person's developer-insights rows for the workspace: org-chart node, person-scope dashboard metrics, AI-tool fact rows, HRIS absences, and readiness run requester linkage. Granular categories default to all enabled when the body is omitted. `personId` is the org-chart `person_id` (typically work email); URL-encode the path segment (e.g. `alice%40example.com`).
+         */
+        post: operations["eraseInsightsPerson"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/insights/ai-usage-spend/aggregated-teams": {
         parameters: {
             query?: never;
@@ -821,7 +841,7 @@ export interface paths {
         put?: never;
         /**
          * Refresh AI tool integration snapshots
-         * @description Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress. On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error.
+         * @description Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress. On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error. Pass `full=true` to force a full re-sync that ignores the incremental daily-usage watermark and re-pulls the full initial window (six calendar months for Claude Enterprise) — used to backfill historical months after an ingestion-granularity change. Omitted/false performs a normal incremental refresh.
          */
         post: operations["refreshWorkspaceAiTool"];
         delete?: never;
@@ -2204,6 +2224,27 @@ export interface components {
             /** @enum {string} */
             role: "admin" | "editor" | "viewer";
         };
+        /** @description Granular person erasure categories. All default to true when omitted. */
+        EraseInsightsPersonBodyDto: {
+            /** @description Remove the person node from `tai_workspace_config.org_chart`. */
+            orgChart?: boolean;
+            /** @description Delete person-scope rows in `tai_workspace_dashboard_metrics`. */
+            dashboardMetrics?: boolean;
+            /** @description Delete AI-tool seats and fact rows keyed to the person. */
+            aiToolData?: boolean;
+            /** @description Delete HRIS absence rows for the person's email. */
+            absences?: boolean;
+            /** @description Clear `requested_by_user_id` on readiness runs for matching app users. */
+            readinessAnonymize?: boolean;
+        };
+        EraseInsightsPersonResultDto: {
+            /** @enum {boolean} */
+            deleted: true;
+            aiToolRowsDeleted: number;
+            absencesDeleted: number;
+            readinessRunsAnonymized: number;
+            auditEntriesAnonymized: number;
+        };
         OrgChartNodeDto: {
             id: string;
             name: string;
@@ -4058,6 +4099,11 @@ export interface components {
         } | unknown | unknown;
         /** @enum {string} */
         ThemePreference: "light" | "dark" | "system";
+        /**
+         * @description User-configured dashboard background refresh cadence.
+         * @enum {string}
+         */
+        DataRefreshInterval: "off" | "1m" | "5m" | "10m";
         NotificationPreferencesDto: {
             /** @description Sync/health status notifications. */
             status: boolean;
@@ -4073,6 +4119,7 @@ export interface components {
             sidebarCollapsed: boolean;
             /** @description IANA timezone name */
             timezone: string;
+            dataRefreshInterval: components["schemas"]["DataRefreshInterval"];
             notifications: components["schemas"]["NotificationPreferencesDto"];
         };
         ValidationIssueDto: {
@@ -4561,6 +4608,8 @@ export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
 export type InviteTeamMemberBodyDto = components['schemas']['InviteTeamMemberBodyDto'];
 export type UpdateTeamMemberRoleBodyDto = components['schemas']['UpdateTeamMemberRoleBodyDto'];
+export type EraseInsightsPersonBodyDto = components['schemas']['EraseInsightsPersonBodyDto'];
+export type EraseInsightsPersonResultDto = components['schemas']['EraseInsightsPersonResultDto'];
 export type OrgChartNodeDto = components['schemas']['OrgChartNodeDto'];
 export type OrgChartTreeNodeDto = components['schemas']['OrgChartTreeNodeDto'];
 export type ScoringOrgChartDto = components['schemas']['ScoringOrgChartDto'];
@@ -4739,6 +4788,7 @@ export type JourneyStepId = components['schemas']['JourneyStepId'];
 export type JourneyProgressDto = components['schemas']['JourneyProgressDto'];
 export type JourneyProgressUpdateDto = components['schemas']['JourneyProgressUpdateDto'];
 export type ThemePreference = components['schemas']['ThemePreference'];
+export type DataRefreshInterval = components['schemas']['DataRefreshInterval'];
 export type NotificationPreferencesDto = components['schemas']['NotificationPreferencesDto'];
 export type PreferencesDto = components['schemas']['PreferencesDto'];
 export type ValidationIssueDto = components['schemas']['ValidationIssueDto'];
@@ -5976,6 +6026,63 @@ export interface operations {
             };
         };
     };
+    eraseInsightsPerson: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Org-chart person_id (URL-encoded when it contains `@`). */
+                personId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                /**
+                 * @example {
+                 *       "orgChart": true,
+                 *       "dashboardMetrics": true,
+                 *       "aiToolData": true,
+                 *       "absences": true,
+                 *       "readinessAnonymize": true
+                 *     }
+                 */
+                "application/json": components["schemas"]["EraseInsightsPersonBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Person data erased or anonymized */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EraseInsightsPersonResultDto"];
+                };
+            };
+            /** @description Invalid body or personId */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found, malformed workspaceId, or person not in org chart */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAiUsageSpendAggregatedTeams: {
         parameters: {
             query?: {
@@ -6976,7 +7083,10 @@ export interface operations {
     };
     refreshWorkspaceAiTool: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Force a full re-sync (ignore the daily-usage watermark, re-pull the full initial window). Truthy only for `true` or `1`. */
+                full?: "true" | "1";
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];