@thinkai/tai-api-contract 2.149.0 → 2.151.0

package/src/generated/openapi.ts

@@ -3701,6 +3701,114 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/notifications/email/unsubscribe": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Confirm a Message Center email unsubscribe (public)
+         * @description **Unauthenticated.** Mail scanners prefetch GET, so this page does not change preferences. Status email cannot be turned off; the page says so. Other categories show a button that POSTs the same token. An unknown or expired token is `400` HTML.
+         */
+        get: operations["getNotificationEmailUnsubscribe"];
+        put?: never;
+        /**
+         * Apply a Message Center email unsubscribe (public)
+         * @description **Unauthenticated.** Sets that category's email cell to `off` when the category allows off. A status token leaves status email unchanged. Redirects `303` to `{spa}/settings?tab=preferences`. An unknown or expired token is `400` HTML and does not change preferences.
+         */
+        post: operations["postNotificationEmailUnsubscribe"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/slack/install-url": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Slack install URL for Message Center
+         * @description Workspace admin only. Returns the Slack OAuth authorize URL. State is stored server-side and names this workspace and the signed-in admin. Editor or viewer is `403` with `code` `workspace_admin_required`. Missing Slack app settings are `503` with `code` `slack_not_configured`.
+         */
+        get: operations["getSlackInstallUrl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/slack/callback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Slack OAuth callback
+         * @description Browser return from Slack. The provider redirect does not include the API bearer token. `state` was issued by `getSlackInstallUrl` to a signed-in admin and is single-use. The bot token is stored encrypted only when that user is still a workspace admin. Success redirects to `{spa}/settings?tab=preferences&chat=slack`. Failures redirect to the same page with `slack=error`. The token is never in the redirect.
+         */
+        get: operations["getSlackOauthCallback"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/slack": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Slack connection status
+         * @description Any workspace member. `{ connected, channelName }`. `channelName` is null until an admin saves a channel. The bot token is never returned.
+         */
+        get: operations["getSlackIntegration"];
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect Slack
+         * @description Workspace admin only. Removes the bot token and saved channel. Later Message Center delivery does not post to Slack.
+         */
+        delete: operations["deleteSlackIntegration"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/slack/channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Save the Slack channel for Message Center
+         * @description Workspace admin only. Body `{ channelId }`. Slack must already be connected. The response is the same status object as `getSlackIntegration`, with the channel name Slack returned. Unknown or malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
+         */
+        put: operations["putSlackChannel"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/notifications": {
         parameters: {
             query?: never;
@@ -4099,6 +4207,90 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/teams/install-url": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Microsoft sign-in URL for Teams notification delivery
+         * @description Workspace **admin** only. Returns the Microsoft authorize URL. State carries the workspace and the signed-in admin. Editor or viewer is `403` `workspace_admin_required`.
+         */
+        get: operations["getWorkspaceTeamsInstallUrl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/teams/callback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Finish Teams Microsoft sign-in
+         * @description Public redirect target. The one-time state was minted by a signed-in admin and still requires that user to be a workspace admin. Stores the bot token encrypted and redirects to `{spa}/settings?tab=preferences&chat=teams`.
+         */
+        get: operations["getTeamsIntegrationCallback"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Teams connection status
+         * @description Any workspace member. `{ connected, channelName }`. Never returns the bot token. `channelName` is null until an admin saves a channel.
+         */
+        get: operations["getWorkspaceTeamsConnection"];
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect Teams
+         * @description Workspace **admin** only. Later Message Center posts do not go to Teams. Member chat cells stay unchanged.
+         */
+        delete: operations["deleteWorkspaceTeamsConnection"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/teams/channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Save the Teams channel for notification posts
+         * @description Workspace **admin** only. Body `{ channelId }`. The channel must be visible to the connected Microsoft account. Until a channel is saved, channel-mode delivery is skipped with `chat_channel_unset`.
+         */
+        put: operations["putWorkspaceTeamsChannel"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/zelt/authorize-url": {
         parameters: {
             query?: never;
@@ -4363,6 +4555,19 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        TeamsInstallUrlDto: {
+            /** Format: uri */
+            url: string;
+        };
+        TeamsConnectionDto: {
+            /** @description True after an admin completes Microsoft sign-in. */
+            connected: boolean;
+            /** @description Selected channel display name. Null until an admin saves a channel. */
+            channelName: string | null;
+        };
+        TeamsChannelBodyDto: {
+            channelId: string;
+        };
         ErrorMessageDto: {
             error: string;
             /** @description Machine-readable error code when present (for example `last_admin`). */
@@ -8018,6 +8223,18 @@ export interface components {
             slack: components["schemas"]["NotificationChatChannelsDto"];
             teams: components["schemas"]["NotificationChatChannelsDto"];
         };
+        SlackInstallUrlDto: {
+            /** @description Slack OAuth authorize URL. The bot token is not included. */
+            url: string;
+        };
+        SlackIntegrationStatusDto: {
+            connected: boolean;
+            /** @description Saved channel name. Null until an admin saves a channel, and when disconnected. */
+            channelName: string | null;
+        };
+        SlackChannelBodyDto: {
+            channelId: string;
+        };
         /** @description Partial email cells. Omitted keys are filled with defaults on save (`status` = `digest`, other keys = `off`). */
         PutNotificationEmailChannelsDto: {
             status?: components["schemas"]["NotificationEmailStatusMode"];
@@ -10484,6 +10701,9 @@ export interface components {
     headers: never;
     pathItems: never;
 }
+export type TeamsInstallUrlDto = components['schemas']['TeamsInstallUrlDto'];
+export type TeamsConnectionDto = components['schemas']['TeamsConnectionDto'];
+export type TeamsChannelBodyDto = components['schemas']['TeamsChannelBodyDto'];
 export type ErrorMessageDto = components['schemas']['ErrorMessageDto'];
 export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
@@ -10807,6 +11027,9 @@ export type NotificationChatDeliveryMode = components['schemas']['NotificationCh
 export type NotificationEmailChannelsDto = components['schemas']['NotificationEmailChannelsDto'];
 export type NotificationChatChannelsDto = components['schemas']['NotificationChatChannelsDto'];
 export type NotificationChannelsDto = components['schemas']['NotificationChannelsDto'];
+export type SlackInstallUrlDto = components['schemas']['SlackInstallUrlDto'];
+export type SlackIntegrationStatusDto = components['schemas']['SlackIntegrationStatusDto'];
+export type SlackChannelBodyDto = components['schemas']['SlackChannelBodyDto'];
 export type PutNotificationEmailChannelsDto = components['schemas']['PutNotificationEmailChannelsDto'];
 export type PutNotificationChatChannelsDto = components['schemas']['PutNotificationChatChannelsDto'];
 export type PutNotificationChannelsDto = components['schemas']['PutNotificationChannelsDto'];
@@ -20679,139 +20902,80 @@ export interface operations {
             };
         };
     };
-    listNotifications: {
+    getNotificationEmailUnsubscribe: {
         parameters: {
-            query?: {
-                limit?: number;
-                offset?: number;
-                /** @description `all` returns every severity. `needs_action` returns only `warning` and `destructive`. Omitted is `all`. */
-                view?: "all" | "needs_action";
-                /** @description Omit to include read and unread rows. `true` is unread only. `false` is read only. */
-                unread?: boolean;
+            query: {
+                /** @description Opaque unsubscribe token from the email. Only its SHA-256 hash is stored. */
+                token: string;
             };
             header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Page of notifications */
+            /** @description Confirm page. Preferences are unchanged. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NotificationListDto"];
+                    "text/html": string;
                 };
             };
-            /** @description Invalid `view` or `unread` */
+            /** @description Unknown or expired token */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
+                    "text/html": string;
                 };
             };
-            401: components["responses"]["Unauthorized"];
         };
     };
-    getNotificationUnreadCount: {
+    postNotificationEmailUnsubscribe: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
+            query: {
+                /** @description Opaque unsubscribe token from the email. Only its SHA-256 hash is stored. */
+                token: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Unread count for the current user in this workspace (respecting notification preferences) */
+            /** @description Preference updated when no SPA origin is configured. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["NotificationUnreadCountDto"];
-                };
-            };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    postNotificationRead: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-                id: components["parameters"]["NotificationId"];
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Updated */
-            204: {
-                headers: {
-                    [name: string]: unknown;
+                    "text/html": string;
                 };
-                content?: never;
             };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    postNotificationsReadAll: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Updated */
-            204: {
+            /** @description Preference updated, or left unchanged for status email. */
+            303: {
                 headers: {
+                    /** @description `{spa}/settings?tab=preferences` */
+                    Location?: string;
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    postAiStrategyRecommend: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AiStrategyRecommendBodyDto"];
-            };
-        };
-        responses: {
-            /** @description Plan */
-            200: {
+            /** @description Unknown or expired token */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AiStrategyPlanDto"];
+                    "text/html": string;
                 };
             };
-            401: components["responses"]["Unauthorized"];
         };
     };
-    getJourneyProgress: {
+    getSlackInstallUrl: {
         parameters: {
             query?: never;
             header?: never;
@@ -20822,63 +20986,33 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Progress (empty completedStepIds when no row exists yet; updatedAt is synthetic in that case) */
+            /** @description Slack authorize URL */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["JourneyProgressDto"];
+                    "application/json": components["schemas"]["SlackInstallUrlDto"];
                 };
             };
-            /** @description Malformed workspaceId */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
-                };
-            };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not a workspace admin */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-        };
-    };
-    putJourneyProgress: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
-            };
-        };
-        responses: {
-            /** @description Saved progress */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["JourneyProgressDto"];
-                };
-            };
-            /** @description Body fails validation (non-array, invalid entries, too many steps) */
-            400: {
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -20886,94 +21020,78 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+            /** @description Slack app client id, secret, API origin, or SPA origin is unset */
+            503: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "error": "Slack is not configured",
+                     *       "code": "slack_not_configured"
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
         };
     };
-    getMyPreferences: {
+    getSlackOauthCallback: {
         parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Preferences */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["PreferencesDto"];
-                };
+            query: {
+                code?: string;
+                state: string;
+                error?: string;
             };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    putMyPreferences: {
-        parameters: {
-            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PutPreferencesBodyDto"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description Saved preferences */
-            200: {
+            /** @description Redirect to Settings → Preferences */
+            302: {
                 headers: {
+                    Location?: string;
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["PreferencesDto"];
-                };
+                content?: never;
             };
-            /** @description Validation failed, or Status email was set to off (`code` `notification_channel_required`). */
-            400: {
+            /** @description Slack app settings are unset and no SPA origin is available */
+            503: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PreferencesValidationErrorDto"] | components["schemas"]["NotificationChannelRequiredErrorDto"];
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
         };
     };
-    getMyConsent: {
+    getSlackIntegration: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Consent record */
+            /** @description Slack connection status */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ConsentRecordDto"];
+                    "application/json": components["schemas"]["SlackIntegrationStatusDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
-            /** @description No consent record stored yet */
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -20984,65 +21102,52 @@ export interface operations {
             };
         };
     };
-    putMyConsent: {
+    deleteSlackIntegration: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PutConsentBodyDto"];
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
-            /** @description Saved consent record */
-            200: {
+            /** @description Slack disconnected */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ConsentRecordDto"];
-                };
+                content?: never;
             };
-            /** @description Validation failed */
-            400: {
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not a workspace admin */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ConsentValidationErrorDto"];
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    getAppShell: {
-        parameters: {
-            query?: {
-                /** @description Optional workspace scope for banner, notifications, journey, and connectors. Omitted or unresolvable values yield the base shell without workspace extras. */
-                workspaceId?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description App shell bootstrap payload. Workspace-scoped fields (`banner`, `unreadCount`, `journeyProgress`, `connectorsSnapshot`) appear only when `workspaceId` resolves to a workspace the caller belongs to. */
-            200: {
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AppShellDto"];
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
         };
     };
-    postOrgChartImport: {
+    putSlackChannel: {
         parameters: {
             query?: never;
             header?: never;
@@ -21053,31 +21158,51 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["OrgChartImportBodyDto"];
+                "application/json": components["schemas"]["SlackChannelBodyDto"];
             };
         };
         responses: {
-            /** @description Parsed persons from uploaded CSV (not persisted server-side) */
+            /** @description Channel saved */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["OrgChartImportResultDto"];
+                    "application/json": components["schemas"]["SlackIntegrationStatusDto"];
                 };
             };
-            /** @description Invalid body or storage path */
+            /** @description channelId is missing, malformed, or unknown to Slack */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "error": "Slack channel was not found",
+                     *       "code": "invalid_slack_channel"
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Storage object not found */
+            /** @description Caller is not a workspace admin */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace does not exist or malformed workspaceId */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -21086,29 +21211,48 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Failed to download file from storage */
-            502: {
+            /** @description Slack is not connected */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "error": "Slack is not connected",
+                     *       "code": "slack_not_connected"
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Storage import not configured or service unavailable */
-            503: {
+            /** @description Slack rejected the lookup */
+            502: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
+                    /**
+                     * @example {
+                     *       "error": "Slack did not accept the channel",
+                     *       "code": "slack_request_failed"
+                     *     }
+                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
         };
     };
-    getYourAiJourneyHero: {
+    listNotifications: {
         parameters: {
-            query?: never;
+            query?: {
+                limit?: number;
+                offset?: number;
+                /** @description `all` returns every severity. `needs_action` returns only `warning` and `destructive`. Omitted is `all`. */
+                view?: "all" | "needs_action";
+                /** @description Omit to include read and unread rows. `true` is unread only. `false` is read only. */
+                unread?: boolean;
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -21117,19 +21261,17 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Hero bootstrap payload */
+            /** @description Page of notifications */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["YourAiJourneyHeroDto"];
+                    "application/json": components["schemas"]["NotificationListDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+            /** @description Invalid `view` or `unread` */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -21137,9 +21279,10 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            401: components["responses"]["Unauthorized"];
         };
     };
-    getYourAiJourneyDashboardSecondary: {
+    getNotificationUnreadCount: {
         parameters: {
             query?: never;
             header?: never;
@@ -21150,67 +21293,91 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Secondary dashboard bootstrap payload */
+            /** @description Unread count for the current user in this workspace (respecting notification preferences) */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DashboardSecondaryDto"];
+                    "application/json": components["schemas"]["NotificationUnreadCountDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
-                };
-            };
         };
     };
-    getYourAiJourneyAnalytics: {
+    postNotificationRead: {
         parameters: {
             query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
+                id: components["parameters"]["NotificationId"];
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Analytics summary */
-            200: {
+            /** @description Updated */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["YourAiJourneyAnalyticsDto"];
-                };
+                content?: never;
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
+        };
+    };
+    postNotificationsReadAll: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
+            401: components["responses"]["Unauthorized"];
         };
     };
-    getYourAiJourneyPrSignals: {
+    postAiStrategyRecommend: {
         parameters: {
-            query?: {
-                /** @description Number of weekly buckets to return (1–52; default 8). */
-                limit?: number;
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AiStrategyRecommendBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Plan */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiStrategyPlanDto"];
+                };
             };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    getJourneyProgress: {
+        parameters: {
+            query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -21219,16 +21386,16 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Weekly PR signals */
+            /** @description Progress (empty completedStepIds when no row exists yet; updatedAt is synthetic in that case) */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["YourAiJourneyPrSignalsDto"];
+                    "application/json": components["schemas"]["JourneyProgressDto"];
                 };
             };
-            /** @description Invalid query parameter (limit out of range) */
+            /** @description Malformed workspaceId */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -21250,7 +21417,7 @@ export interface operations {
             };
         };
     };
-    getYourAiJourneyReadinessAggregate: {
+    putJourneyProgress: {
         parameters: {
             query?: never;
             header?: never;
@@ -21259,15 +21426,28 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
+            };
+        };
         responses: {
-            /** @description Readiness aggregate */
+            /** @description Saved progress */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["YourAiJourneyReadinessAggregateDto"];
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            /** @description Body fails validation (non-array, invalid entries, too many steps) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -21283,29 +21463,81 @@ export interface operations {
             };
         };
     };
-    getYourAiJourneyProgress: {
+    getMyPreferences: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Preferences */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreferencesDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    putMyPreferences: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutPreferencesBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Saved preferences */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreferencesDto"];
+                };
+            };
+            /** @description Validation failed, or Status email was set to off (`code` `notification_channel_required`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreferencesValidationErrorDto"] | components["schemas"]["NotificationChannelRequiredErrorDto"];
+                };
             };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    getMyConsent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Journey progress */
+            /** @description Consent record */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["JourneyProgressDto"];
+                    "application/json": components["schemas"]["ConsentRecordDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
+            /** @description No consent record stored yet */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -21316,53 +21548,65 @@ export interface operations {
             };
         };
     };
-    putYourAiJourneyProgress: {
+    putMyConsent: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
+                "application/json": components["schemas"]["PutConsentBodyDto"];
             };
         };
         responses: {
-            /** @description Saved progress */
+            /** @description Saved consent record */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["JourneyProgressDto"];
+                    "application/json": components["schemas"]["ConsentRecordDto"];
                 };
             };
-            /** @description Body fails validation (non-array, invalid entries, too many steps) */
+            /** @description Validation failed */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
+                    "application/json": components["schemas"]["ConsentValidationErrorDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+        };
+    };
+    getAppShell: {
+        parameters: {
+            query?: {
+                /** @description Optional workspace scope for banner, notifications, journey, and connectors. Omitted or unresolvable values yield the base shell without workspace extras. */
+                workspaceId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description App shell bootstrap payload. Workspace-scoped fields (`banner`, `unreadCount`, `journeyProgress`, `connectorsSnapshot`) appear only when `workspaceId` resolves to a workspace the caller belongs to. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorMessageDto"];
+                    "application/json": components["schemas"]["AppShellDto"];
                 };
             };
+            401: components["responses"]["Unauthorized"];
         };
     };
-    getYourAiJourneyAgenticFoundation: {
+    postOrgChartImport: {
         parameters: {
             query?: never;
             header?: never;
@@ -21371,20 +21615,33 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["OrgChartImportBodyDto"];
+            };
+        };
         responses: {
-            /** @description Agentic foundation dashboard */
+            /** @description Parsed persons from uploaded CSV (not persisted server-side) */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AgenticFoundationDashboardDto"];
+                    "application/json": components["schemas"]["OrgChartImportResultDto"];
+                };
+            };
+            /** @description Invalid body or storage path */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
+            /** @description Storage object not found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -21393,14 +21650,29 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description Failed to download file from storage */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Storage import not configured or service unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
-    getYourAiJourneyProductivity: {
+    getYourAiJourneyHero: {
         parameters: {
-            query?: {
-                /** @description Upper bound of the requested window (ISO 8601; defaults to now). */
-                windowEnd?: string;
-            };
+            query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -21409,13 +21681,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Productivity metrics snapshot */
+            /** @description Hero bootstrap payload */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DashboardProductivityDto"];
+                    "application/json": components["schemas"]["YourAiJourneyHeroDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -21431,12 +21703,9 @@ export interface operations {
             };
         };
     };
-    getYourAiJourneyAiSpend: {
+    getYourAiJourneyDashboardSecondary: {
         parameters: {
-            query?: {
-                /** @description Time range — `4w` (4 weeks), `8w` (8 weeks), or `q` (quarter, 12 weeks). */
-                rangeId?: "4w" | "8w" | "q";
-            };
+            query?: never;
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -21445,13 +21714,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description AI spend aggregation */
+            /** @description Secondary dashboard bootstrap payload */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["YourAiJourneyAiSpendDto"];
+                    "application/json": components["schemas"]["DashboardSecondaryDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -21467,14 +21736,309 @@ export interface operations {
             };
         };
     };
-    listWorkspaceAbsences: {
+    getYourAiJourneyAnalytics: {
         parameters: {
-            query?: {
-                /** @description Start of date window (ISO YYYY-MM-DD). Defaults to today. */
-                from?: string;
-                /** @description End of date window (ISO YYYY-MM-DD). Defaults to 90 days from today. */
-                to?: string;
-            };
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Analytics summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAnalyticsDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyPrSignals: {
+        parameters: {
+            query?: {
+                /** @description Number of weekly buckets to return (1–52; default 8). */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Weekly PR signals */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyPrSignalsDto"];
+                };
+            };
+            /** @description Invalid query parameter (limit out of range) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyReadinessAggregate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Readiness aggregate */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyReadinessAggregateDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Journey progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putYourAiJourneyProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["JourneyProgressUpdateDto"];
+            };
+        };
+        responses: {
+            /** @description Saved progress */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["JourneyProgressDto"];
+                };
+            };
+            /** @description Body fails validation (non-array, invalid entries, too many steps) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAgenticFoundation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Agentic foundation dashboard */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgenticFoundationDashboardDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyProductivity: {
+        parameters: {
+            query?: {
+                /** @description Upper bound of the requested window (ISO 8601; defaults to now). */
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Productivity metrics snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DashboardProductivityDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getYourAiJourneyAiSpend: {
+        parameters: {
+            query?: {
+                /** @description Time range — `4w` (4 weeks), `8w` (8 weeks), or `q` (quarter, 12 weeks). */
+                rangeId?: "4w" | "8w" | "q";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description AI spend aggregation */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyAiSpendDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listWorkspaceAbsences: {
+        parameters: {
+            query?: {
+                /** @description Start of date window (ISO YYYY-MM-DD). Defaults to today. */
+                from?: string;
+                /** @description End of date window (ISO YYYY-MM-DD). Defaults to 90 days from today. */
+                to?: string;
+            };
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -21491,26 +22055,330 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "absences": [
-                     *         {
-                     *           "source": "personio",
-                     *           "employeeEmail": "alice@example.com",
-                     *           "absenceType": "Vacation",
-                     *           "startDate": "2025-07-01",
-                     *           "endDate": "2025-07-05",
-                     *           "halfDayStart": false,
-                     *           "halfDayEnd": false,
-                     *           "status": "approved"
-                     *         }
-                     *       ],
-                     *       "syncedAt": "2025-06-30T08:00:00.000Z"
+                     *       "absences": [
+                     *         {
+                     *           "source": "personio",
+                     *           "employeeEmail": "alice@example.com",
+                     *           "absenceType": "Vacation",
+                     *           "startDate": "2025-07-01",
+                     *           "endDate": "2025-07-05",
+                     *           "halfDayStart": false,
+                     *           "halfDayEnd": false,
+                     *           "status": "approved"
+                     *         }
+                     *       ],
+                     *       "syncedAt": "2025-06-30T08:00:00.000Z"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["WorkspaceAbsenceListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getWorkspaceTeamsInstallUrl: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Authorize URL */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=example&state=example-state"
                      *     }
                      */
-                    "application/json": components["schemas"]["WorkspaceAbsenceListDto"];
+                    "application/json": components["schemas"]["TeamsInstallUrlDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Teams app credentials are not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams sign-in is not configured",
+                     *       "code": "teams_not_configured"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getTeamsIntegrationCallback: {
+        parameters: {
+            query: {
+                code?: string;
+                state: string;
+                error?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Redirect to Settings → Preferences */
+            302: {
+                headers: {
+                    Location?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description SPA origin is not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getWorkspaceTeamsConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connection status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "connected": true,
+                     *       "channelName": "General"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["TeamsConnectionDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    deleteWorkspaceTeamsConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Disconnected */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putWorkspaceTeamsChannel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "channelId": "19:example@thread.tacv2"
+                 *     }
+                 */
+                "application/json": components["schemas"]["TeamsChannelBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Channel saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "connected": true,
+                     *       "channelName": "General"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["TeamsConnectionDto"];
+                };
+            };
+            /** @description Missing channelId, or the channel was not found */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Teams is not connected */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams is not connected",
+                     *       "code": "teams_not_connected"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Microsoft Graph rejected the channel lookup */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams channel lookup failed",
+                     *       "code": "teams_graph_failed"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     postWorkspaceZeltAuthorizeUrl: {