@thinkai/tai-api-contract 2.156.0 → 2.157.0

package/dist/generated/openapi.d.ts

@@ -3773,7 +3773,7 @@ export interface paths {
         };
         /**
          * 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`.
+         * @description Workspace admin only. Returns the Slack OAuth authorize URL with `incoming-webhook` scope. 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;
@@ -3793,7 +3793,7 @@ export interface paths {
         };
         /**
          * 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}/workspace/preferences?chat=slack`. Failures redirect to the same page with `slack=error`. The token is never in the redirect.
+         * @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. Install requests `incoming-webhook` only. The encrypted incoming-webhook URL and the channel Slack returns are stored only when that user is still a workspace admin. Success redirects to `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same page with `slack=error`. The webhook URL is never in the redirect.
          */
         get: operations["getSlackOauthCallback"];
         put?: never;
@@ -3813,14 +3813,14 @@ export interface paths {
         };
         /**
          * Slack connection status
-         * @description Any workspace member. `{ connected, channelName }`. `channelName` is null until an admin saves a channel. The bot token is never returned.
+         * @description Any workspace member. `{ connected, channelName }`. `connected` is true only when a decryptable install webhook is stored. `channelName` is the channel chosen on Slack's install screen (null when not connected). Secrets are 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.
+         * @description Workspace admin only. Removes the install webhook, optional bot token, and saved channel. Later Message Center delivery does not post to Slack.
          */
         delete: operations["deleteSlackIntegration"];
         options?: never;
@@ -3837,8 +3837,8 @@ export interface paths {
         };
         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`.
+         * Change Slack channel (requires reinstall)
+         * @description Workspace admin only. Body `{ channelId }`. The notification channel is chosen on Slack's install screen with the incoming webhook; this route does not rewrite channel metadata. When Slack is connected, the API returns `409` with `code` `slack_channel_reinstall_required` — reconnect via `getSlackInstallUrl` to pick a different channel. Malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
          */
         put: operations["putSlackChannel"];
         post?: never;
@@ -8353,12 +8353,13 @@ export interface components {
             teams: components["schemas"]["NotificationChatChannelsDto"];
         };
         SlackInstallUrlDto: {
-            /** @description Slack OAuth authorize URL. The bot token is not included. */
+            /** @description Slack OAuth authorize URL (`incoming-webhook` scope). Secrets are not included. */
             url: string;
         };
         SlackIntegrationStatusDto: {
+            /** @description True only when a decryptable install webhook URL is stored for this workspace. */
             connected: boolean;
-            /** @description Saved channel name. Null until an admin saves a channel, and when disconnected. */
+            /** @description Channel name returned by Slack at install time. Null when not connected. */
             channelName: string | null;
         };
         SlackChannelBodyDto: {
@@ -21396,7 +21397,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Channel saved */
+            /** @description Not returned. The channel is chosen on Slack's install screen; when connected the API responds with `409` `slack_channel_reinstall_required`. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -21405,7 +21406,7 @@ export interface operations {
                     "application/json": components["schemas"]["SlackIntegrationStatusDto"];
                 };
             };
-            /** @description channelId is missing, malformed, or unknown to Slack */
+            /** @description channelId is missing or malformed */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -21413,7 +21414,7 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "error": "Slack channel was not found",
+                     *       "error": "channelId is required",
                      *       "code": "invalid_slack_channel"
                      *     }
                      */
@@ -21445,33 +21446,12 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Slack is not connected */
+            /** @description Slack is not connected (`slack_not_connected`), or the channel cannot be changed without a new install (`slack_channel_reinstall_required`). */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "Slack is not connected",
-                     *       "code": "slack_not_connected"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["ErrorMessageDto"];
-                };
-            };
-            /** @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"];
                 };
             };