@iblai/iblai-api 2025.11.13-teams-bot-renovation-4-ai → 2025.11.14-teams-bot-renovation-2-ai

package/sdk_schema.yml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ibl-data-manager
-  version: 4.90.2-ai-plus
+  version: 4.90.4-ai-plus
   description: API for iblai
 paths:
   /api/ai-account/connected-services/callback/:
@@ -33268,26 +33268,33 @@ paths:
         \        - Limited search capabilities\n        - No personalization\n\n \
         \       **Authenticated Users:**\n        - Full access based on platform\
         \ permissions (scoped to requested platform)\n        - Personalized results\n\
-        \        - Access to tenant-specific mentors\n\n        **Available Filters:**\n\
-        \        - `query`: Search term to filter mentors by name or description\n\
-        \        - `tenant`: Filter by tenant/organization platform key(s)\n     \
-        \   - `category`: Filter by mentor category (comma-separated)\n        - `subjects`:\
-        \ Filter by mentor subject (comma-separated)\n        - `types`: Filter by\
-        \ mentor type (comma-separated)\n        - `llm`: Filter by LLM provider (comma-separated,\
-        \ e.g., GPT-4, Claude)\n        - `visibility`: Filter by visibility level\
-        \ (comma-separated: viewable_by_anyone, viewable_by_tenant_students, viewable_by_tenant_admins)\n\
-        \        - `created_by`: Filter mentors created by specific user (for personalized\
-        \ search)\n        - `include_main_public_mentors`: Include main tenant public\
-        \ mentors\n\n        **Facets:**\n        The response includes facets with\
-        \ aggregated counts for all filterable attributes:\n        - categories,\
-        \ subjects, types, llm_providers, visibility\n        All facet values can\
-        \ be used as filter parameters in subsequent requests.\n\n        Notes:\n\
-        \        - Detail view is removed; use the ibl_ai_mentor app for mentor details\n\
-        \        - include_main_public_mentors=true shows only VIEWABLE_BY_ANYONE\
-        \ mentors from the main tenant across tenants\n        - For authenticated\
-        \ requests, platform_key is required when username is provided\n        -\
-        \ Frontend uses `llm` parameter name (backend maps to `llm_provider` automatically)\n\
-        \        "
+        \        - Access to tenant-specific mentors\n\n        **Required Parameters\
+        \ (Authenticated Users):**\n        - `platform_key` OR `tenant`: Platform\
+        \ key for RBAC enforcement (required for authenticated requests)\n       \
+        \   - Use `platform_key` (preferred) or `tenant` (backward compatibility)\
+        \ - both serve the same purpose\n          - If both are provided, `platform_key`\
+        \ takes precedence\n\n        **Available Filters:**\n        - `query`: Search\
+        \ term to filter mentors by name or description\n        - `tenant`: Filter\
+        \ by tenant/organization platform key(s) - can also be used as alias for `platform_key`\
+        \ (backward compatibility)\n        - `category`: Filter by mentor category\
+        \ (comma-separated)\n        - `subjects`: Filter by mentor subject (comma-separated)\n\
+        \        - `types`: Filter by mentor type (comma-separated)\n        - `llm`:\
+        \ Filter by LLM provider (comma-separated, e.g., GPT-4, Claude)\n        -\
+        \ `visibility`: Filter by visibility level (comma-separated: viewable_by_anyone,\
+        \ viewable_by_tenant_students, viewable_by_tenant_admins)\n        - `created_by`:\
+        \ Filter mentors created by specific user (for personalized search)\n    \
+        \    - `include_main_public_mentors`: Include main tenant public mentors\n\
+        \n        **Facets:**\n        The response includes facets with aggregated\
+        \ counts for all filterable attributes:\n        - categories, subjects, types,\
+        \ llm_providers, visibility\n        All facet values can be used as filter\
+        \ parameters in subsequent requests.\n\n        Notes:\n        - Detail view\
+        \ is removed; use the ibl_ai_mentor app for mentor details\n        - include_main_public_mentors=true\
+        \ shows only VIEWABLE_BY_ANYONE mentors from the main tenant across tenants\n\
+        \        - For authenticated requests, either `platform_key` or `tenant` is\
+        \ required when username is provided\n        - `tenant` parameter serves\
+        \ dual purpose: as a filter for multiple tenants, or as an alias for `platform_key`\
+        \ (backward compatibility)\n        - Frontend uses `llm` parameter name (backend\
+        \ maps to `llm_provider` automatically)\n        "
       summary: Search and filter AI mentors across the platform
       parameters:
       - in: query
@@ -33333,8 +33340,8 @@ paths:
         schema:
           type: string
           minLength: 1
-        description: Platform key for RBAC enforcement
-        required: true
+        description: Platform key for RBAC enforcement. Required for authenticated
+          requests. Can also use 'tenant' parameter as an alias (backward compatibility).
       - in: query
         name: query
         schema:
@@ -33352,7 +33359,8 @@ paths:
         schema:
           type: string
           minLength: 1
-        description: Tenant key(s) (CSV)
+        description: Tenant key(s) (CSV). Can be used as a filter for multiple tenants,
+          or as an alias for 'platform_key' in authenticated requests (backward compatibility).
       - in: query
         name: types
         schema:
@@ -33549,11 +33557,13 @@ paths:
         \ organization/platform.\n        This endpoint provides a personalized view\
         \ of the user's own mentors with\n        support for filtering, pagination,\
         \ and detailed mentor information.\n\n        **Authentication Required:**\n\
-        \        - username: Required for personalized mentor access\n        - platform_key:\
-        \ Required for tenant-specific content\n\n        **Features:**\n        -\
-        \ User's own mentors only\n        - Personalization data (access counts,\
-        \ last used)\n        - Filtering and faceted search\n        - Pagination\
-        \ support\n        - Detail and list views\n        "
+        \        - username: Required for personalized mentor access\n        - platform_key\
+        \ OR tenant: Required for tenant-specific content (both serve the same purpose)\n\
+        \          - Use `platform_key` (preferred) or `tenant` (backward compatibility)\n\
+        \          - If both are provided, `platform_key` takes precedence\n\n   \
+        \     **Features:**\n        - User's own mentors only\n        - Personalization\
+        \ data (access counts, last used)\n        - Filtering and faceted search\n\
+        \        - Pagination support\n        - Detail and list views\n        "
       summary: Get mentors created by a specific user
       parameters:
       - in: query
@@ -33610,8 +33620,8 @@ paths:
         schema:
           type: string
           minLength: 1
-        description: Platform key for authentication
-        required: true
+        description: Platform key for authentication. Required for authenticated requests.
+          Can also use 'tenant' parameter as an alias (backward compatibility).
       - in: query
         name: query
         schema:
@@ -33630,6 +33640,13 @@ paths:
           items:
             type: string
         description: Filter by tags
+      - in: query
+        name: tenant
+        schema:
+          type: string
+          minLength: 1
+        description: Tenant key (alias for 'platform_key' for backward compatibility).
+          Can be used instead of 'platform_key' - both serve the same purpose.
       - in: query
         name: username
         schema:
@@ -72072,6 +72089,11 @@ components:
           type: string
           nullable: true
           description: Course short description from edx_data
+        edx_data:
+          type: object
+          additionalProperties: {}
+          nullable: true
+          description: Full edx_data from CourseInfo model (includes all edX metadata)
       required:
       - course_id
       - course_title
@@ -75612,6 +75634,15 @@ components:
           description: Disclaimer to be shown to the user when the mentor is used.
         enable_disclaimer:
           type: boolean
+        show_attachment:
+          type: boolean
+          description: Show attachments on mentor.
+        show_voice_call:
+          type: boolean
+          description: Show voice call button on mentor.
+        show_voice_record:
+          type: boolean
+          description: Show voice recording button on mentor.
         embed_is_context_aware:
           type: boolean
           description: Allow embedded mentor to read content on the embedded web page.
@@ -75927,6 +75958,15 @@ components:
           description: Disclaimer to be shown to the user when the mentor is used.
         enable_disclaimer:
           type: boolean
+        show_attachment:
+          type: boolean
+          description: Show attachments on mentor.
+        show_voice_call:
+          type: boolean
+          description: Show voice call button on mentor.
+        show_voice_record:
+          type: boolean
+          description: Show voice recording button on mentor.
         embed_is_context_aware:
           type: boolean
           description: Allow embedded mentor to read content on the embedded web page.
@@ -76324,6 +76364,12 @@ components:
           type: string
         enable_disclaimer:
           type: boolean
+        show_attachment:
+          type: boolean
+        show_voice_call:
+          type: boolean
+        show_voice_record:
+          type: boolean
         embed_is_context_aware:
           type: boolean
         embed_open_by_default:
@@ -76685,6 +76731,15 @@ components:
         enable_disclaimer:
           type: boolean
           readOnly: true
+        show_attachment:
+          type: boolean
+          readOnly: true
+        show_voice_call:
+          type: boolean
+          readOnly: true
+        show_voice_record:
+          type: boolean
+          readOnly: true
         embed_is_context_aware:
           type: boolean
           readOnly: true
@@ -76911,6 +76966,9 @@ components:
       - safety_response
       - safety_system_prompt
       - seo_tags
+      - show_attachment
+      - show_voice_call
+      - show_voice_record
       - subjects
       - suggested_prompts
       - system_prompt
@@ -77012,6 +77070,15 @@ components:
         enable_disclaimer:
           type: boolean
           readOnly: true
+        show_attachment:
+          type: boolean
+          readOnly: true
+        show_voice_call:
+          type: boolean
+          readOnly: true
+        show_voice_record:
+          type: boolean
+          readOnly: true
         embed_is_context_aware:
           type: boolean
           readOnly: true
@@ -77155,6 +77222,9 @@ components:
       - proactive_prompt
       - proactive_response
       - recently_accessed_at
+      - show_attachment
+      - show_voice_call
+      - show_voice_record
       - subjects
       - suggested_prompts
       - types
@@ -77272,6 +77342,12 @@ components:
           items:
             type: integer
           nullable: true
+        show_attachment:
+          type: boolean
+        show_voice_call:
+          type: boolean
+        show_voice_record:
+          type: boolean
         embed_is_context_aware:
           type: boolean
         embed_open_by_default:
@@ -80723,6 +80799,15 @@ components:
           description: Disclaimer to be shown to the user when the mentor is used.
         enable_disclaimer:
           type: boolean
+        show_attachment:
+          type: boolean
+          description: Show attachments on mentor.
+        show_voice_call:
+          type: boolean
+          description: Show voice call button on mentor.
+        show_voice_record:
+          type: boolean
+          description: Show voice recording button on mentor.
         embed_is_context_aware:
           type: boolean
           description: Allow embedded mentor to read content on the embedded web page.

package/src/core/OpenAPI.ts

@@ -21,7 +21,7 @@ export type OpenAPIConfig = {
 
 export const OpenAPI: OpenAPIConfig = {
     BASE: 'https://base.manager.iblai.app',
-    VERSION: '4.90.2-ai-plus',
+    VERSION: '4.90.4-ai-plus',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/src/models/CourseRecommendation.ts

@@ -46,5 +46,9 @@ export type CourseRecommendation = {
      * Course short description from edx_data
      */
     short_description?: string | null;
+    /**
+     * Full edx_data from CourseInfo model (includes all edX metadata)
+     */
+    edx_data?: Record<string, any> | null;
 };
 

package/src/models/Mentor.ts

@@ -61,6 +61,18 @@ export type Mentor = {
      */
     disclaimer?: string;
     enable_disclaimer?: boolean;
+    /**
+     * Show attachments on mentor.
+     */
+    show_attachment?: boolean;
+    /**
+     * Show voice call button on mentor.
+     */
+    show_voice_call?: boolean;
+    /**
+     * Show voice recording button on mentor.
+     */
+    show_voice_record?: boolean;
     /**
      * Allow embedded mentor to read content on the embedded web page.
      */

package/src/models/MentorCreate.ts

@@ -51,6 +51,18 @@ export type MentorCreate = {
      */
     disclaimer?: string;
     enable_disclaimer?: boolean;
+    /**
+     * Show attachments on mentor.
+     */
+    show_attachment?: boolean;
+    /**
+     * Show voice call button on mentor.
+     */
+    show_voice_call?: boolean;
+    /**
+     * Show voice recording button on mentor.
+     */
+    show_voice_record?: boolean;
     /**
      * Allow embedded mentor to read content on the embedded web page.
      */

package/src/models/MentorFromTemplateWithSettingRequest.ts

@@ -39,6 +39,9 @@ export type MentorFromTemplateWithSettingRequest = {
     proactive_prompt?: string;
     disclaimer?: string;
     enable_disclaimer?: boolean;
+    show_attachment?: boolean;
+    show_voice_call?: boolean;
+    show_voice_record?: boolean;
     embed_is_context_aware?: boolean;
     embed_open_by_default?: boolean;
     embed_show_attachment?: boolean;

package/src/models/MentorSettings.ts

@@ -44,6 +44,9 @@ export type MentorSettings = {
     readonly proactive_prompt: string;
     readonly disclaimer: string;
     readonly enable_disclaimer: boolean;
+    readonly show_attachment: boolean;
+    readonly show_voice_call: boolean;
+    readonly show_voice_record: boolean;
     readonly embed_is_context_aware: boolean;
     readonly embed_open_by_default: boolean;
     readonly embed_show_attachment: boolean;

package/src/models/MentorSettingsPublic.ts

@@ -42,6 +42,9 @@ export type MentorSettingsPublic = {
     readonly proactive_prompt: string;
     readonly disclaimer: string;
     readonly enable_disclaimer: boolean;
+    readonly show_attachment: boolean;
+    readonly show_voice_call: boolean;
+    readonly show_voice_record: boolean;
     readonly embed_is_context_aware: boolean;
     readonly embed_open_by_default: boolean;
     readonly embed_show_attachment: boolean;

package/src/models/MentorSettingsRequest.ts

@@ -53,6 +53,9 @@ export type MentorSettingsRequest = {
     enable_suggested_prompts?: boolean | null;
     enable_guided_prompts?: boolean | null;
     mcp_servers?: Array<number> | null;
+    show_attachment?: boolean;
+    show_voice_call?: boolean;
+    show_voice_record?: boolean;
     embed_is_context_aware?: boolean;
     embed_open_by_default?: boolean;
     embed_show_attachment?: boolean;

package/src/models/PatchedMentorCreate.ts

@@ -51,6 +51,18 @@ export type PatchedMentorCreate = {
      */
     disclaimer?: string;
     enable_disclaimer?: boolean;
+    /**
+     * Show attachments on mentor.
+     */
+    show_attachment?: boolean;
+    /**
+     * Show voice call button on mentor.
+     */
+    show_voice_call?: boolean;
+    /**
+     * Show voice recording button on mentor.
+     */
+    show_voice_record?: boolean;
     /**
      * Allow embedded mentor to read content on the embedded web page.
      */

package/src/services/AiSearchService.ts

@@ -28,9 +28,14 @@ export class AiSearchService {
      * - Personalized results
      * - Access to tenant-specific mentors
      *
+     * **Required Parameters (Authenticated Users):**
+     * - `platform_key` OR `tenant`: Platform key for RBAC enforcement (required for authenticated requests)
+     * - Use `platform_key` (preferred) or `tenant` (backward compatibility) - both serve the same purpose
+     * - If both are provided, `platform_key` takes precedence
+     *
      * **Available Filters:**
      * - `query`: Search term to filter mentors by name or description
-     * - `tenant`: Filter by tenant/organization platform key(s)
+     * - `tenant`: Filter by tenant/organization platform key(s) - can also be used as alias for `platform_key` (backward compatibility)
      * - `category`: Filter by mentor category (comma-separated)
      * - `subjects`: Filter by mentor subject (comma-separated)
      * - `types`: Filter by mentor type (comma-separated)
@@ -47,30 +52,27 @@ export class AiSearchService {
      * Notes:
      * - Detail view is removed; use the ibl_ai_mentor app for mentor details
      * - include_main_public_mentors=true shows only VIEWABLE_BY_ANYONE mentors from the main tenant across tenants
-     * - For authenticated requests, platform_key is required when username is provided
+     * - For authenticated requests, either `platform_key` or `tenant` is required when username is provided
+     * - `tenant` parameter serves dual purpose: as a filter for multiple tenants, or as an alias for `platform_key` (backward compatibility)
      * - Frontend uses `llm` parameter name (backend maps to `llm_provider` automatically)
      *
      * @returns V2GlobalMentorSearchResponse
      * @throws ApiError
      */
     public static v2GlobalMentorSearch({
-        platformKey,
         category,
         createdBy,
         includeMainPublicMentors = false,
         limit,
         llm,
         offset,
+        platformKey,
         query,
         subjects,
         tenant,
         types,
         visibility,
     }: {
-        /**
-         * Platform key for RBAC enforcement
-         */
-        platformKey: string,
         /**
          * Mentor category filter
          */
@@ -95,6 +97,10 @@ export class AiSearchService {
          * Number of results to skip
          */
         offset?: number,
+        /**
+         * Platform key for RBAC enforcement. Required for authenticated requests. Can also use 'tenant' parameter as an alias (backward compatibility).
+         */
+        platformKey?: string,
         /**
          * Search query for mentors
          */
@@ -104,7 +110,7 @@ export class AiSearchService {
          */
         subjects?: string,
         /**
-         * Tenant key(s) (CSV)
+         * Tenant key(s) (CSV). Can be used as a filter for multiple tenants, or as an alias for 'platform_key' in authenticated requests (backward compatibility).
          */
         tenant?: string,
         /**
@@ -268,7 +274,9 @@ export class AiSearchService {
      *
      * **Authentication Required:**
      * - username: Required for personalized mentor access
-     * - platform_key: Required for tenant-specific content
+     * - platform_key OR tenant: Required for tenant-specific content (both serve the same purpose)
+     * - Use `platform_key` (preferred) or `tenant` (backward compatibility)
+     * - If both are provided, `platform_key` takes precedence
      *
      * **Features:**
      * - User's own mentors only
@@ -281,7 +289,6 @@ export class AiSearchService {
      * @throws ApiError
      */
     public static v2PersonalizedMentors({
-        platformKey,
         audience,
         category,
         limit,
@@ -289,16 +296,14 @@ export class AiSearchService {
         offset,
         orderBy,
         orderDirection,
+        platformKey,
         query,
         returnFacet,
         tags,
+        tenant,
         username,
         visibility,
     }: {
-        /**
-         * Platform key for authentication
-         */
-        platformKey: string,
         /**
          * Filter by audience
          */
@@ -330,6 +335,10 @@ export class AiSearchService {
          * * `desc` - desc
          */
         orderDirection?: 'asc' | 'desc',
+        /**
+         * Platform key for authentication. Required for authenticated requests. Can also use 'tenant' parameter as an alias (backward compatibility).
+         */
+        platformKey?: string,
         /**
          * Search query for personalized mentors
          */
@@ -342,6 +351,10 @@ export class AiSearchService {
          * Filter by tags
          */
         tags?: Array<string>,
+        /**
+         * Tenant key (alias for 'platform_key' for backward compatibility). Can be used instead of 'platform_key' - both serve the same purpose.
+         */
+        tenant?: string,
         /**
          * Username for authentication (required for unauthenticated requests)
          */
@@ -366,6 +379,7 @@ export class AiSearchService {
                 'query': query,
                 'return_facet': returnFacet,
                 'tags': tags,
+                'tenant': tenant,
                 'username': username,
                 'visibility': visibility,
             },