@usecortex_ai/node 0.1.2 → 0.2.0

package/dist/api/resources/upload/client/Client.js

@@ -44,10 +44,16 @@ const CortexAI = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class Upload {
-    constructor(_options = {}) {
+    constructor(_options) {
         this._options = _options;
     }
     /**
+     * Upload multiple documents simultaneously for efficient bulk processing.
+     *
+     * This endpoint allows you to upload several files at once, which is ideal for large document collections or periodic data imports. Each file gets processed asynchronously, and you can track the progress of individual files using their returned file IDs.
+     *
+     * The system automatically handles file parsing, content extraction, and indexing across all uploaded documents. You'll receive confirmation once all files are queued for processing.
+     *
      * @param {CortexAI.BodyBatchUploadUploadBatchUploadPost} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -86,9 +92,6 @@ class Upload {
         if (request.document_metadata != null) {
             _request.append("document_metadata", request.document_metadata);
         }
-        if (request.relations != null) {
-            _request.append("relations", request.relations);
-        }
         const _maybeEncodedRequest = await _request.getRequest();
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: await this._getAuthorizationHeader() }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
         const _response = await core.fetcher({
@@ -147,6 +150,12 @@ class Upload {
         }
     }
     /**
+     * Update multiple existing documents with new content and metadata.
+     *
+     * Use this endpoint when you need to replace or modify several documents that are already in your knowledge base. Each file must correspond to an existing source ID, ensuring that updates are applied to the correct documents.
+     *
+     * The system processes updates asynchronously, allowing you to continue working while your documents are re-indexed. Track the progress using the returned file IDs to know when updates are complete.
+     *
      * @param {CortexAI.BodyBatchUpdateUploadBatchUpdatePatch} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -190,9 +199,6 @@ class Upload {
         if (request.document_metadata != null) {
             _request.append("document_metadata", request.document_metadata);
         }
-        if (request.relations != null) {
-            _request.append("relations", request.relations);
-        }
         const _maybeEncodedRequest = await _request.getRequest();
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: await this._getAuthorizationHeader() }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
         const _response = await core.fetcher({
@@ -251,6 +257,12 @@ class Upload {
         }
     }
     /**
+     * Upload a single document for processing and indexing into your knowledge base.
+     *
+     * This endpoint accepts documents in various formats and processes them for search and retrieval. You can include custom metadata to help organize and categorize your content.
+     *
+     * The system extracts text content, processes it asynchronously, and makes it available for search queries. You can track the processing status using the returned file ID.
+     *
      * @param {CortexAI.BodyUploadFilesUploadUploadDocumentPost} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -287,9 +299,6 @@ class Upload {
         if (request.document_metadata != null) {
             _request.append("document_metadata", request.document_metadata);
         }
-        if (request.relations != null) {
-            _request.append("relations", request.relations);
-        }
         const _maybeEncodedRequest = await _request.getRequest();
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: await this._getAuthorizationHeader() }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
         const _response = await core.fetcher({
@@ -348,6 +357,12 @@ class Upload {
         }
     }
     /**
+     * Replace an existing document with updated content.
+     *
+     * This endpoint allows you to update a specific document that's already in your knowledge base. Provide the source ID of the document you want to modify, along with the new file content.
+     *
+     * The system will process your update asynchronously and re-index the document with the new content. You can monitor the progress using the returned file ID.
+     *
      * @param {CortexAI.BodyUpdateFileUploadUpdateDocumentPatch} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -386,9 +401,6 @@ class Upload {
         if (request.document_metadata != null) {
             _request.append("document_metadata", request.document_metadata);
         }
-        if (request.relations != null) {
-            _request.append("relations", request.relations);
-        }
         const _maybeEncodedRequest = await _request.getRequest();
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: await this._getAuthorizationHeader() }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
         const _response = await core.fetcher({
@@ -447,6 +459,12 @@ class Upload {
         }
     }
     /**
+     * Upload structured data from applications or APIs for indexing.
+     *
+     * This endpoint is designed for importing data from applications. If you are specifically using Cortex to provide search to an application, you should prefer this endpoint. It accepts structured source objects and allows you to clearly define contents of attachments
+     *
+     * The system processes each source asynchronously and makes the content available for search and retrieval. Use this when you need to integrate search and indexing from data in your applications into your knowledge base.
+     *
      * @param {CortexAI.UploadUploadAppSourcesRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -532,8 +550,11 @@ class Upload {
         }
     }
     /**
-     * Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-     * otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+     * Upload text or markdown content directly for processing.
+     *
+     * This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+     *
+     * You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
      *
      * @param {CortexAI.UploadUploadMarkdownRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
@@ -622,8 +643,11 @@ class Upload {
         }
     }
     /**
-     * Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-     * otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+     * Upload text or markdown content directly for processing.
+     *
+     * This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+     *
+     * You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
      *
      * @param {CortexAI.UploadUploadTextRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
@@ -712,6 +736,12 @@ class Upload {
         }
     }
     /**
+     * Update existing text or markdown content with new information.
+     *
+     * This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+     *
+     * The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+     *
      * @param {CortexAI.UploadUpdateMarkdownRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -801,6 +831,12 @@ class Upload {
         }
     }
     /**
+     * Update existing text or markdown content with new information.
+     *
+     * This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+     *
+     * The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+     *
      * @param {CortexAI.UploadUpdateTextRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -890,6 +926,12 @@ class Upload {
         }
     }
     /**
+     * Upload pre-computed embeddings for advanced similarity search.
+     *
+     * This endpoint accepts vector embeddings that you've generated externally, allowing you to integrate with custom embedding models or existing vector databases. The embeddings represent chunks of your content as numerical vectors.
+     *
+     * The system stores these embeddings and makes them available for semantic search and similarity matching. Use this when you want to leverage specialized embedding models or have existing vector representations.
+     *
      * @param {CortexAI.EmbeddingsUploadRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -975,6 +1017,12 @@ class Upload {
         }
     }
     /**
+     * Update existing embeddings with new vector representations.
+     *
+     * This endpoint allows you to modify embeddings that are already stored in your knowledge base. Provide updated vector representations for specific chunks of content, identified by their chunk IDs.
+     *
+     * The system will replace the existing embeddings with your new ones, ensuring that similarity searches reflect the most current vector representations. Use this when you need to update embeddings due to model improvements or content changes.
+     *
      * @param {CortexAI.EmbeddingsUpdateRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -1059,6 +1107,12 @@ class Upload {
         }
     }
     /**
+     * Extract and index content from web pages automatically.
+     *
+     * This endpoint initiates web scraping for the specified URL, extracting the main content, text, and structure from the webpage. It's perfect for capturing articles, documentation, or any web content you want to include in your knowledge base.
+     *
+     * The system processes the webpage content asynchronously, cleaning and structuring the information for optimal search and retrieval. Use this when you need to add web content without manual copying and pasting.
+     *
      * @param {CortexAI.UploadScrapeWebpageRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -1149,6 +1203,12 @@ class Upload {
         }
     }
     /**
+     * Update web scraping content with fresh data from the source URL.
+     *
+     * This endpoint refreshes the content for an existing web scraping job. Provide the source ID of the webpage content you want to update, and the system will re-scrape the URL to capture any changes.
+     *
+     * The updated content gets processed asynchronously and re-indexed in your knowledge base. Use this to keep web content current when the source pages are frequently updated.
+     *
      * @param {CortexAI.UploadUpdateWebpageRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -1238,6 +1298,12 @@ class Upload {
         }
     }
     /**
+     * Remove documents and content from your knowledge base.
+     *
+     * This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+     *
+     * Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+     *
      * @param {CortexAI.DeleteMemoryRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -1299,6 +1365,12 @@ class Upload {
         }
     }
     /**
+     * Remove documents and content from your knowledge base.
+     *
+     * This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+     *
+     * Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+     *
      * @param {CortexAI.DeleteMemoryRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -1360,10 +1432,11 @@ class Upload {
         }
     }
     /**
-     * Verify the processing status of an uploaded file.
+     * Check the current processing status of your uploaded content.
+     *
+     * This endpoint allows you to monitor the progress of documents, text, or other content you've uploaded. Simply provide the file ID to see whether processing is complete, still in progress, or if any errors occurred.
      *
-     * Returns:
-     *     ProcessingStatusResponse: Processing status information
+     * Use this to determine when your content is ready for search and retrieval, or to troubleshoot any processing issues.
      *
      * @param {CortexAI.UploadVerifyProcessingRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
@@ -1446,11 +1519,7 @@ class Upload {
         }
     }
     async _getAuthorizationHeader() {
-        const bearer = await core.Supplier.get(this._options.token);
-        if (bearer != null) {
-            return `Bearer ${bearer}`;
-        }
-        return undefined;
+        return `Bearer ${await core.Supplier.get(this._options.token)}`;
     }
 }
 exports.Upload = Upload;

package/dist/api/resources/upload/client/requests/BodyBatchUpdateUploadBatchUpdatePatch.d.ts

@@ -10,11 +10,27 @@ import * as core from "../../../../../core/index.js";
  *     }
  */
 export interface BodyBatchUpdateUploadBatchUpdatePatch {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The document file to upload (e.g., PDF, DOCX, TXT) */
     files: core.file.Uploadable.FileLike[];
+    /** List of source IDs corresponding to the files being updated */
     source_ids?: string[];
+    /**
+     * JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+     *
+     * Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+     *
+     */
     tenant_metadata?: string;
+    /**
+     * JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+     *
+     * Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+     *
+     *
+     */
     document_metadata?: string;
-    relations?: string;
 }

package/dist/api/resources/upload/client/requests/BodyBatchUploadUploadBatchUploadPost.d.ts

@@ -10,10 +10,25 @@ import * as core from "../../../../../core/index.js";
  *     }
  */
 export interface BodyBatchUploadUploadBatchUploadPost {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The document file to upload (e.g., PDF, DOCX, TXT) */
     files: core.file.Uploadable.FileLike[];
+    /**
+     * JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+     *
+     * Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+     *
+     */
     tenant_metadata?: string;
+    /**
+     * JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+     *
+     * Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+     *
+     *
+     */
     document_metadata?: string;
-    relations?: string;
 }

package/dist/api/resources/upload/client/requests/BodyUpdateFileUploadUpdateDocumentPatch.d.ts

@@ -11,11 +11,27 @@ import * as core from "../../../../../core/index.js";
  *     }
  */
 export interface BodyUpdateFileUploadUpdateDocumentPatch {
+    /** The source ID of the document to update */
     source_id: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The document file to upload (e.g., PDF, DOCX, TXT) */
     file: core.file.Uploadable.FileLike;
+    /**
+     * JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+     *
+     * Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+     *
+     */
     tenant_metadata?: string;
+    /**
+     * JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+     *
+     * Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+     *
+     *
+     */
     document_metadata?: string;
-    relations?: string;
 }

package/dist/api/resources/upload/client/requests/BodyUploadFilesUploadUploadDocumentPost.d.ts

@@ -10,10 +10,25 @@ import * as core from "../../../../../core/index.js";
  *     }
  */
 export interface BodyUploadFilesUploadUploadDocumentPost {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The document file to upload (e.g., PDF, DOCX, TXT) */
     file: core.file.Uploadable.FileLike;
+    /**
+     * JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+     *
+     * Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+     *
+     */
     tenant_metadata?: string;
+    /**
+     * JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+     *
+     * Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+     *
+     *
+     */
     document_metadata?: string;
-    relations?: string;
 }

package/dist/api/resources/upload/client/requests/EmbeddingsUpdateRequest.d.ts

@@ -8,7 +8,10 @@
  *     }
  */
 export interface EmbeddingsUpdateRequest {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The embeddings of source you want to index */
     embeddings?: Record<string, number[]>;
 }

package/dist/api/resources/upload/client/requests/EmbeddingsUploadRequest.d.ts

@@ -9,8 +9,12 @@
  *     }
  */
 export interface EmbeddingsUploadRequest {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** The embeddings of source you want to index */
     embeddings: number[][];
+    /** The Source ID of the target source you want to index */
     file_id?: string;
 }

package/dist/api/resources/upload/client/requests/UploadScrapeWebpageRequest.d.ts

@@ -11,9 +11,13 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadScrapeWebpageRequest {
+    /** The URL of the webpage to scrape and index */
     web_url: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** Optional custom file ID for the scraped content. If not provided, a unique ID will be generated */
     file_id?: string;
     body: CortexAI.BodyScrapeWebpageUploadScrapeWebpagePost;
 }

package/dist/api/resources/upload/client/requests/UploadUpdateMarkdownRequest.d.ts

@@ -13,8 +13,11 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUpdateMarkdownRequest {
+    /** The source ID of the document to update */
     source_id: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
     body: CortexAI.MarkdownUploadRequest;
 }

package/dist/api/resources/upload/client/requests/UploadUpdateTextRequest.d.ts

@@ -13,8 +13,11 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUpdateTextRequest {
+    /** The source ID of the document to update */
     source_id: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
     body: CortexAI.MarkdownUploadRequest;
 }

package/dist/api/resources/upload/client/requests/UploadUpdateWebpageRequest.d.ts

@@ -12,9 +12,13 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUpdateWebpageRequest {
+    /** The URL of the webpage to re-scrape */
     web_url: string;
+    /** The file ID of the existing web scraping job to update */
     source_id: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
     body: CortexAI.BodyUpdateScrapeJobUploadUpdateWebpagePatch;
 }

package/dist/api/resources/upload/client/requests/UploadUploadAppSourcesRequest.d.ts

@@ -10,7 +10,10 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUploadAppSourcesRequest {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
+    /** List of structured source objects containing app-generated data to be indexed */
     body: CortexAI.SourceModel[];
 }

package/dist/api/resources/upload/client/requests/UploadUploadMarkdownRequest.d.ts

@@ -12,7 +12,9 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUploadMarkdownRequest {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
     body: CortexAI.MarkdownUploadRequest;
 }

package/dist/api/resources/upload/client/requests/UploadUploadTextRequest.d.ts

@@ -12,7 +12,9 @@ import * as CortexAI from "../../../../index.js";
  *     }
  */
 export interface UploadUploadTextRequest {
+    /** Unique identifier for the tenant/organization */
     tenant_id: string;
+    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
     sub_tenant_id?: string;
     body: CortexAI.MarkdownUploadRequest;
 }

package/dist/api/resources/upload/client/requests/UploadVerifyProcessingRequest.d.ts

@@ -8,6 +8,8 @@
  *     }
  */
 export interface UploadVerifyProcessingRequest {
+    /** The file ID to check processing status for */
     file_id: string;
+    /** Unique identifier for the tenant/organization */
     tenant_id?: string;
 }

package/dist/api/resources/user/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace User {
         environment?: core.Supplier<environments.CortexAIEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token?: core.Supplier<core.BearerToken | undefined>;
+        token: core.Supplier<core.BearerToken>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -28,12 +28,15 @@ export declare namespace User {
 }
 export declare class User {
     protected readonly _options: User.Options;
-    constructor(_options?: User.Options);
+    constructor(_options: User.Options);
     /**
-     * Create a new tenant for the authenticated user.
+     * Create a tenant for your account.
      *
-     * Returns:
-     *     TenantCreateResponse: Success response with tenant creation details
+     * Use this endpoint to initialize a tenant space you can use for ingestion, embeddings, and search. Optionally include a metadata schema to enforce consistent attributes across documents.
+     *
+     * Expected outcome
+     * - A tenant is created and returned with its identifier.
+     * - If the tenant already exists, you receive a success message with the existing identifier.
      *
      * @param {CortexAI.BodyCreateTenantUserCreateTenantPost} request
      * @param {User.RequestOptions} requestOptions - Request-specific configuration.
@@ -51,5 +54,5 @@ export declare class User {
      */
     createTenant(request?: CortexAI.BodyCreateTenantUserCreateTenantPost, requestOptions?: User.RequestOptions): core.HttpResponsePromise<CortexAI.TenantCreateData>;
     private __createTenant;
-    protected _getAuthorizationHeader(): Promise<string | undefined>;
+    protected _getAuthorizationHeader(): Promise<string>;
 }

package/dist/api/resources/user/client/Client.js

@@ -44,14 +44,17 @@ const CortexAI = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class User {
-    constructor(_options = {}) {
+    constructor(_options) {
         this._options = _options;
     }
     /**
-     * Create a new tenant for the authenticated user.
+     * Create a tenant for your account.
      *
-     * Returns:
-     *     TenantCreateResponse: Success response with tenant creation details
+     * Use this endpoint to initialize a tenant space you can use for ingestion, embeddings, and search. Optionally include a metadata schema to enforce consistent attributes across documents.
+     *
+     * Expected outcome
+     * - A tenant is created and returned with its identifier.
+     * - If the tenant already exists, you receive a success message with the existing identifier.
      *
      * @param {CortexAI.BodyCreateTenantUserCreateTenantPost} request
      * @param {User.RequestOptions} requestOptions - Request-specific configuration.
@@ -134,11 +137,7 @@ class User {
         }
     }
     async _getAuthorizationHeader() {
-        const bearer = await core.Supplier.get(this._options.token);
-        if (bearer != null) {
-            return `Bearer ${bearer}`;
-        }
-        return undefined;
+        return `Bearer ${await core.Supplier.get(this._options.token)}`;
     }
 }
 exports.User = User;

package/dist/api/resources/user/client/requests/BodyCreateTenantUserCreateTenantPost.d.ts

@@ -6,6 +6,7 @@
  *     {}
  */
 export interface BodyCreateTenantUserCreateTenantPost {
+    /** Unique identifier for the tenant/organization */
     tenant_id?: string;
     tenant_metadata_schema?: Record<string, unknown>[];
 }