@thinkai/tai-api-contract 2.150.0 → 2.152.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.150.0
+  version: 2.152.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -9236,7 +9236,7 @@ paths:
       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
+        `{spa}/workspace/preferences`. An unknown or expired token is `400` HTML and
         does not change preferences.
       operationId: postNotificationEmailUnsubscribe
       security: []
@@ -9252,7 +9252,7 @@ paths:
           description: Preference updated, or left unchanged for status email.
           headers:
             Location:
-              description: "`{spa}/settings?tab=preferences`"
+              description: "`{spa}/workspace/preferences`"
               schema:
                 type: string
         "400":
@@ -9326,7 +9326,7 @@ paths:
         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
+        `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same
         page with `slack=error`. The token is never in the redirect.
       parameters:
         - name: code
@@ -9489,6 +9489,61 @@ paths:
                 error: Slack did not accept the channel
                 code: slack_request_failed
 
+  /workspaces/{workspaceId}/notification-preferences:
+    get:
+      tags: [Notifications]
+      summary: Member notification preferences for this workspace
+      description: >
+        In-app Message Center switches and email, Slack, and Teams cells for the
+        current member in this workspace. Missing stored values use the same defaults
+        as account preferences (`email.status` is `digest`; other channel cells are `off`).
+      operationId: getWorkspaceNotificationPreferences
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Preferences for this member in this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceNotificationPreferencesDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    put:
+      tags: [Notifications]
+      summary: Save member notification preferences for this workspace
+      description: >
+        Replaces the in-app switches. `notificationChannels` may be omitted to keep
+        stored cells. `email.status` = `off` is `400` `notification_channel_required`.
+        Account `PUT /me/preferences` no longer changes the inbox or delivery.
+      operationId: putWorkspaceNotificationPreferences
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PutWorkspaceNotificationPreferencesBodyDto"
+      responses:
+        "200":
+          description: Saved preferences
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceNotificationPreferencesDto"
+        "400":
+          description: Invalid body, or status email set to off
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Status email cannot be turned off
+                code: notification_channel_required
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
   /workspaces/{workspaceId}/notifications:
     get:
       tags: [Notifications]
@@ -9566,6 +9621,35 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/notifications/read:
+    post:
+      tags: [Notifications]
+      summary: Mark selected notifications read
+      description: >
+        Marks only the given ids read for the current member in this workspace.
+        Ids that are missing or belong to someone else are ignored. `ids` is 1 to 100
+        uuids.
+      operationId: postNotificationsRead
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/NotificationReadIdsBodyDto"
+      responses:
+        "204":
+          description: Updated
+        "400":
+          description: Invalid ids
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
   /workspaces/{workspaceId}/notifications/{id}/read:
     post:
       tags: [Notifications]
@@ -10249,6 +10333,239 @@ paths:
         "403":
           $ref: "#/components/responses/Forbidden"
 
+  /workspaces/{workspaceId}/integrations/teams/install-url:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Microsoft sign-in URL for Teams notification delivery
+      operationId: getWorkspaceTeamsInstallUrl
+      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`.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Authorize URL
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsInstallUrlDto"
+              example:
+                url: "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=example&state=example-state"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+        "503":
+          description: Teams app credentials are not configured
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams sign-in is not configured
+                code: teams_not_configured
+
+  /integrations/teams/callback:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Finish Teams Microsoft sign-in
+      operationId: getTeamsIntegrationCallback
+      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}/workspace/preferences?chat=teams`.
+      security: []
+      parameters:
+        - name: code
+          in: query
+          schema:
+            type: string
+        - name: state
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: error
+          in: query
+          schema:
+            type: string
+      responses:
+        "302":
+          description: Redirect to Settings → Preferences
+          headers:
+            Location:
+              schema:
+                type: string
+                example: "https://app.example.com/workspace/preferences?chat=teams"
+        "503":
+          description: SPA origin is not configured
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/integrations/teams:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Teams connection status
+      operationId: getWorkspaceTeamsConnection
+      description: >
+        Any workspace member. `{ connected, channelName }`. Never returns the bot token.
+        `channelName` is null until an admin saves a channel.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Connection status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsConnectionDto"
+              example:
+                connected: true
+                channelName: General
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+    delete:
+      tags: [Integrations, Notifications]
+      summary: Disconnect Teams
+      operationId: deleteWorkspaceTeamsConnection
+      description: >
+        Workspace **admin** only. Later Message Center posts do not go to Teams.
+        Member chat cells stay unchanged.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "204":
+          description: Disconnected
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+
+  /workspaces/{workspaceId}/integrations/teams/channel:
+    put:
+      tags: [Integrations, Notifications]
+      summary: Save the Teams channel for notification posts
+      operationId: putWorkspaceTeamsChannel
+      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`.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TeamsChannelBodyDto"
+            example:
+              channelId: "19:example@thread.tacv2"
+      responses:
+        "200":
+          description: Channel saved
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsConnectionDto"
+              example:
+                connected: true
+                channelName: General
+        "400":
+          description: Missing channelId, or the channel was not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              examples:
+                invalid:
+                  value:
+                    error: channelId is required
+                    code: invalid_input
+                missing:
+                  value:
+                    error: Teams channel was not found
+                    code: teams_channel_not_found
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+        "409":
+          description: Teams is not connected
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams is not connected
+                code: teams_not_connected
+        "502":
+          description: Microsoft Graph rejected the channel lookup
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams channel lookup failed
+                code: teams_graph_failed
+
   /workspaces/{workspaceId}/integrations/zelt/authorize-url:
     post:
       tags: [HRIS, Integrations]
@@ -11261,6 +11578,35 @@ components:
             error: zenhr_sync_in_progress
 
   schemas:
+    TeamsInstallUrlDto:
+      type: object
+      required: [url]
+      properties:
+        url:
+          type: string
+          format: uri
+
+    TeamsConnectionDto:
+      type: object
+      required: [connected, channelName]
+      properties:
+        connected:
+          type: boolean
+          description: True after an admin completes Microsoft sign-in.
+        channelName:
+          type: string
+          nullable: true
+          description: Selected channel display name. Null until an admin saves a channel.
+
+    TeamsChannelBodyDto:
+      type: object
+      required: [channelId]
+      properties:
+        channelId:
+          type: string
+          minLength: 1
+          maxLength: 256
+
     ErrorMessageDto:
       type: object
       required: [error]
@@ -19107,6 +19453,44 @@ components:
         system:
           $ref: "#/components/schemas/NotificationChatDeliveryMode"
 
+    WorkspaceNotificationPreferencesDto:
+      type: object
+      additionalProperties: false
+      required: [notifications, notificationChannels]
+      description: >
+        Message Center switches and delivery cells for one member in one workspace.
+      properties:
+        notifications:
+          $ref: "#/components/schemas/NotificationPreferencesDto"
+        notificationChannels:
+          $ref: "#/components/schemas/NotificationChannelsDto"
+
+    PutWorkspaceNotificationPreferencesBodyDto:
+      type: object
+      additionalProperties: false
+      required: [notifications]
+      description: >
+        Body for `PUT /workspaces/{workspaceId}/notification-preferences`.
+        Omit `notificationChannels` to keep stored cells.
+      properties:
+        notifications:
+          $ref: "#/components/schemas/NotificationPreferencesDto"
+        notificationChannels:
+          $ref: "#/components/schemas/PutNotificationChannelsDto"
+
+    NotificationReadIdsBodyDto:
+      type: object
+      additionalProperties: false
+      required: [ids]
+      properties:
+        ids:
+          type: array
+          minItems: 1
+          maxItems: 100
+          items:
+            type: string
+            format: uuid
+
     NotificationChannelsDto:
       type: object
       additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.150.0",
+  "version": "2.152.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -19,9 +19,9 @@
     }
   },
   "devDependencies": {
-    "@stoplight/spectral-cli": "^6.16.3",
-    "@types/node": "^26.6.3",
-    "jsonpath-plus": "^11.1.0",
+    "@stoplight/spectral-cli": "^6.17.0",
+    "@types/node": "^26.6.4",
+    "jsonpath-plus": "^11.1.1",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"
   },