carbon_ruby_sdk 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e19f8989c416d45b0cf4dc8a5b261b1f0b37d5111084c20bd48dac1f3a8ae795
-  data.tar.gz: be5d4f7386b026b0dd0810f65ff4b916bcad4aeacb3105b513611814cdfe2524
+  metadata.gz: bf47c03b0e27651aa516a1b57c87c83324e769fb98dd2d983d0bd89c9c7e87d3
+  data.tar.gz: f36807e5b7c143e385e0420641ebf791bef641314eae726214446bcfd6c97a7f
 SHA512:
-  metadata.gz: f5a05f4d3880897ddffc218c189009c0fecf396d14b7c3634951e2a24d508824a99f8e5f2eb107207d7cd157dc289ac2cb0feb4686aac5e68d237d0c9c2962d8
-  data.tar.gz: 494d7bb4ecaff69ce143ad63e4285d7c2a1c91bdde8b62d9231c3bb00f29ebcc013bc1ccdc27316518032143ab56772ff70e7d5593fe35d8a21e6ccdbad88cae
+  metadata.gz: b3a842c472397b3708a9a5517763cdcb3f6cea3dbcbc5af4c5d7f4648f07dae1e2dcd637ba5cdc3b6d1aa2a100483cdcc091cc27f8e4ffbc5e0fd8b066e92fa8
+  data.tar.gz: fc30a060950f4e7b0e8a30463f5c8529de9edf8e4257ea5e4933b451747e79e1cd375e6b29c34047dd716807a3c804f053863e7a5427d067dfdd09c2ad51b35f

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    carbon_ruby_sdk (0.1.4)
+    carbon_ruby_sdk (0.1.6)
       faraday (>= 1.0.1, < 3.0)
       faraday-multipart (~> 1.0, >= 1.0.4)
 

data/README.md

@@ -6,7 +6,7 @@
 
 Connect external data to LLMs, no matter the source.
 
-[![npm](https://img.shields.io/badge/gem-v0.1.4-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.1.4)
+[![npm](https://img.shields.io/badge/gem-v0.1.6-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.1.6)
 
 </div>
 
@@ -77,7 +77,7 @@ Connect external data to LLMs, no matter the source.
 Add to Gemfile:
 
 ```ruby
-gem 'carbon_ruby_sdk', '~> 0.1.4'
+gem 'carbon_ruby_sdk', '~> 0.1.6'
 ```
 
 ## Getting Started<a id="getting-started"></a>
@@ -492,14 +492,13 @@ result = carbon.embeddings.upload_chunks_and_embeddings(
                 {
                     "chunk_number" => 1,
                     "chunk" => "chunk_example",
-                    "embedding" => [
-                        3.14
-                    ],
                 }
             ],
         }
     ],
   overwrite_existing: false,
+  chunks_only: false,
+  custom_credentials: {},
 )
 p result
 ```
@@ -509,6 +508,8 @@ p result
 ##### embedding_model: [`EmbeddingGenerators`](./lib/carbon_ruby_sdk/models/embedding_generators.rb)<a id="embedding_model-embeddinggeneratorslibcarbon_ruby_sdkmodelsembedding_generatorsrb"></a>
 ##### chunks_and_embeddings: Array<[`SingleChunksAndEmbeddingsUploadInput`](./lib/carbon_ruby_sdk/models/single_chunks_and_embeddings_upload_input.rb)><a id="chunks_and_embeddings-array"></a>
 ##### overwrite_existing: `Boolean`<a id="overwrite_existing-boolean"></a>
+##### chunks_only: `Boolean`<a id="chunks_only-boolean"></a>
+##### custom_credentials: `Object`<a id="custom_credentials-object"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -876,6 +877,7 @@ result = carbon.files.resync(
   file_id: 1,
   chunk_size: 1,
   chunk_overlap: 1,
+  force_embedding_generation: false,
 )
 p result
 ```
@@ -885,6 +887,7 @@ p result
 ##### file_id: `Integer`<a id="file_id-integer"></a>
 ##### chunk_size: `Integer`<a id="chunk_size-integer"></a>
 ##### chunk_overlap: `Integer`<a id="chunk_overlap-integer"></a>
+##### force_embedding_generation: `Boolean`<a id="force_embedding_generation-boolean"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [UserFile](./lib/carbon_ruby_sdk/models/user_file.rb)
@@ -1253,7 +1256,10 @@ p result
 
 ### `carbon.integrations.get_oauth_url`<a id="carbonintegrationsget_oauth_url"></a>
 
-Get Oauth Url
+This endpoint can be used to generate the following URLs
+- An OAuth URL for OAuth based connectors
+- A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the
+success state.
 
 #### 🛠️ Usage<a id="🛠️-usage"></a>
 
@@ -1276,6 +1282,8 @@ result = carbon.integrations.get_oauth_url(
   salesforce_domain: "string_example",
   sync_files_on_connection: true,
   set_page_as_boundary: false,
+  data_source_id: 1,
+  connecting_new_account: false,
 )
 p result
 ```
@@ -1298,7 +1306,25 @@ p result
 ##### max_items_per_chunk: `Integer`<a id="max_items_per_chunk-integer"></a>
 ##### salesforce_domain: `String`<a id="salesforce_domain-string"></a>
 ##### sync_files_on_connection: `Boolean`<a id="sync_files_on_connection-boolean"></a>
+Used to specify whether Carbon should attempt to sync all your files
+automatically when authorization is complete. This is only supported for a
+subset of connectors and will be ignored for the rest. Supported connectors:
+Intercom, Zendesk, Gitbook, Confluence, Salesforce, Freshdesk
+
 ##### set_page_as_boundary: `Boolean`<a id="set_page_as_boundary-boolean"></a>
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
+Used to specify a data source to sync from if you have multiple connected. It
+can be skipped if you only have one data source of that type connected or are
+connecting a new account.
+
+##### connecting_new_account: `Boolean`<a id="connecting_new_account-boolean"></a>
+Used to connect a new data source. If not specified, we will attempt to create a
+sync URL for an existing data source based on type and ID.
+
+#### 🔄 Return<a id="🔄-return"></a>
+
+[OuthURLResponse](./lib/carbon_ruby_sdk/models/outh_url_response.rb)
+
 #### 🌐 Endpoint<a id="🌐-endpoint"></a>
 
 `/integrations/oauth_url` `POST`
@@ -1389,10 +1415,15 @@ both system folders like "inbox" and user created folders.
 #### 🛠️ Usage<a id="🛠️-usage"></a>
 
 ```ruby
-result = carbon.integrations.list_folders
+result = carbon.integrations.list_folders(
+  data_source_id: 1,
+)
 p result
 ```
 
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🌐 Endpoint<a id="🌐-endpoint"></a>
 
 `/integrations/outlook/user_folders` `GET`
@@ -1435,10 +1466,15 @@ will have the type "user" and Gmail's default labels will have the type "system"
 #### 🛠️ Usage<a id="🛠️-usage"></a>
 
 ```ruby
-result = carbon.integrations.list_labels
+result = carbon.integrations.list_labels(
+  data_source_id: 1,
+)
 p result
 ```
 
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🌐 Endpoint<a id="🌐-endpoint"></a>
 
 `/integrations/gmail/user_labels` `GET`
@@ -1456,10 +1492,15 @@ support listing up to 250 categories.
 #### 🛠️ Usage<a id="🛠️-usage"></a>
 
 ```ruby
-result = carbon.integrations.list_outlook_categories
+result = carbon.integrations.list_outlook_categories(
+  data_source_id: 1,
+)
 p result
 ```
 
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🌐 Endpoint<a id="🌐-endpoint"></a>
 
 `/integrations/outlook/user_categories` `GET`
@@ -1715,6 +1756,7 @@ result = carbon.integrations.sync_gmail(
   embedding_model: "OPENAI",
   generate_sparse_vectors: false,
   prepend_filename_to_chunks: false,
+  data_source_id: 1,
 )
 p result
 ```
@@ -1729,6 +1771,7 @@ p result
 ##### embedding_model: [`EmbeddingGenerators`](./lib/carbon_ruby_sdk/models/embedding_generators.rb)<a id="embedding_model-embeddinggeneratorslibcarbon_ruby_sdkmodelsembedding_generatorsrb"></a>
 ##### generate_sparse_vectors: `Boolean`<a id="generate_sparse_vectors-boolean"></a>
 ##### prepend_filename_to_chunks: `Boolean`<a id="prepend_filename_to_chunks-boolean"></a>
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -1818,6 +1861,7 @@ result = carbon.integrations.sync_outlook(
   embedding_model: "OPENAI",
   generate_sparse_vectors: false,
   prepend_filename_to_chunks: false,
+  data_source_id: 1,
 )
 p result
 ```
@@ -1833,6 +1877,7 @@ p result
 ##### embedding_model: [`EmbeddingGenerators`](./lib/carbon_ruby_sdk/models/embedding_generators.rb)<a id="embedding_model-embeddinggeneratorslibcarbon_ruby_sdkmodelsembedding_generatorsrb"></a>
 ##### generate_sparse_vectors: `Boolean`<a id="generate_sparse_vectors-boolean"></a>
 ##### prepend_filename_to_chunks: `Boolean`<a id="prepend_filename_to_chunks-boolean"></a>
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -1912,6 +1957,7 @@ result = carbon.integrations.sync_s3_files(
   prepend_filename_to_chunks: false,
   max_items_per_chunk: 1,
   set_page_as_boundary: false,
+  data_source_id: 1,
 )
 p result
 ```
@@ -1928,6 +1974,7 @@ p result
 ##### prepend_filename_to_chunks: `Boolean`<a id="prepend_filename_to_chunks-boolean"></a>
 ##### max_items_per_chunk: `Integer`<a id="max_items_per_chunk-integer"></a>
 ##### set_page_as_boundary: `Boolean`<a id="set_page_as_boundary-boolean"></a>
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)

data/lib/carbon_ruby_sdk/api/embeddings_api.rb

@@ -465,13 +465,17 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param chunks_and_embeddings [Array<SingleChunksAndEmbeddingsUploadInput>] 
     # @param overwrite_existing [Boolean] 
+    # @param chunks_only [Boolean] 
+    # @param custom_credentials [Object] 
     # @param body [ChunksAndEmbeddingsUploadInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def upload_chunks_and_embeddings(embedding_model:, chunks_and_embeddings:, overwrite_existing: false, extra: {})
+    def upload_chunks_and_embeddings(embedding_model:, chunks_and_embeddings:, overwrite_existing: false, chunks_only: false, custom_credentials: SENTINEL, extra: {})
       _body = {}
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:chunks_and_embeddings] = chunks_and_embeddings if chunks_and_embeddings != SENTINEL
       _body[:overwrite_existing] = overwrite_existing if overwrite_existing != SENTINEL
+      _body[:chunks_only] = chunks_only if chunks_only != SENTINEL
+      _body[:custom_credentials] = custom_credentials if custom_credentials != SENTINEL
       chunks_and_embeddings_upload_input = _body
       api_response = upload_chunks_and_embeddings_with_http_info_impl(chunks_and_embeddings_upload_input, extra)
       api_response.data
@@ -482,13 +486,17 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param chunks_and_embeddings [Array<SingleChunksAndEmbeddingsUploadInput>] 
     # @param overwrite_existing [Boolean] 
+    # @param chunks_only [Boolean] 
+    # @param custom_credentials [Object] 
     # @param body [ChunksAndEmbeddingsUploadInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def upload_chunks_and_embeddings_with_http_info(embedding_model:, chunks_and_embeddings:, overwrite_existing: false, extra: {})
+    def upload_chunks_and_embeddings_with_http_info(embedding_model:, chunks_and_embeddings:, overwrite_existing: false, chunks_only: false, custom_credentials: SENTINEL, extra: {})
       _body = {}
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:chunks_and_embeddings] = chunks_and_embeddings if chunks_and_embeddings != SENTINEL
       _body[:overwrite_existing] = overwrite_existing if overwrite_existing != SENTINEL
+      _body[:chunks_only] = chunks_only if chunks_only != SENTINEL
+      _body[:custom_credentials] = custom_credentials if custom_credentials != SENTINEL
       chunks_and_embeddings_upload_input = _body
       upload_chunks_and_embeddings_with_http_info_impl(chunks_and_embeddings_upload_input, extra)
     end

data/lib/carbon_ruby_sdk/api/files_api.rb

@@ -938,13 +938,15 @@ module Carbon
     # @param file_id [Integer] 
     # @param chunk_size [Integer] 
     # @param chunk_overlap [Integer] 
+    # @param force_embedding_generation [Boolean] 
     # @param body [ResyncFileQueryInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def resync(file_id:, chunk_size: SENTINEL, chunk_overlap: SENTINEL, extra: {})
+    def resync(file_id:, chunk_size: SENTINEL, chunk_overlap: SENTINEL, force_embedding_generation: false, extra: {})
       _body = {}
       _body[:file_id] = file_id if file_id != SENTINEL
       _body[:chunk_size] = chunk_size if chunk_size != SENTINEL
       _body[:chunk_overlap] = chunk_overlap if chunk_overlap != SENTINEL
+      _body[:force_embedding_generation] = force_embedding_generation if force_embedding_generation != SENTINEL
       resync_file_query_input = _body
       api_response = resync_with_http_info_impl(resync_file_query_input, extra)
       api_response.data
@@ -955,13 +957,15 @@ module Carbon
     # @param file_id [Integer] 
     # @param chunk_size [Integer] 
     # @param chunk_overlap [Integer] 
+    # @param force_embedding_generation [Boolean] 
     # @param body [ResyncFileQueryInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def resync_with_http_info(file_id:, chunk_size: SENTINEL, chunk_overlap: SENTINEL, extra: {})
+    def resync_with_http_info(file_id:, chunk_size: SENTINEL, chunk_overlap: SENTINEL, force_embedding_generation: false, extra: {})
       _body = {}
       _body[:file_id] = file_id if file_id != SENTINEL
       _body[:chunk_size] = chunk_size if chunk_size != SENTINEL
       _body[:chunk_overlap] = chunk_overlap if chunk_overlap != SENTINEL
+      _body[:force_embedding_generation] = force_embedding_generation if force_embedding_generation != SENTINEL
       resync_file_query_input = _body
       resync_with_http_info_impl(resync_file_query_input, extra)
     end

data/lib/carbon_ruby_sdk/api/integrations_api.rb

@@ -414,6 +414,11 @@ module Carbon
 
     # Get Oauth Url
     #
+    # This endpoint can be used to generate the following URLs
+    # - An OAuth URL for OAuth based connectors
+    # - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the
+    # success state.
+    #
     # @param service [DataSourceType] 
     # @param tags [Object] 
     # @param scope [String] 
@@ -429,11 +434,13 @@ module Carbon
     # @param prepend_filename_to_chunks [Boolean] 
     # @param max_items_per_chunk [Integer] 
     # @param salesforce_domain [String] 
-    # @param sync_files_on_connection [Boolean] 
+    # @param sync_files_on_connection [Boolean] Used to specify whether Carbon should attempt to sync all your files automatically when authorization is complete. This is only supported for a subset of connectors and will be ignored for the rest. Supported connectors: Intercom, Zendesk, Gitbook, Confluence, Salesforce, Freshdesk
     # @param set_page_as_boundary [Boolean] 
+    # @param data_source_id [Integer] Used to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.
+    # @param connecting_new_account [Boolean] Used to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.
     # @param body [OAuthURLRequest] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_oauth_url(service:, tags: SENTINEL, scope: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', zendesk_subdomain: SENTINEL, microsoft_tenant: SENTINEL, sharepoint_site_name: SENTINEL, confluence_subdomain: SENTINEL, generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, salesforce_domain: SENTINEL, sync_files_on_connection: true, set_page_as_boundary: false, extra: {})
+    def get_oauth_url(service:, tags: SENTINEL, scope: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', zendesk_subdomain: SENTINEL, microsoft_tenant: SENTINEL, sharepoint_site_name: SENTINEL, confluence_subdomain: SENTINEL, generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, salesforce_domain: SENTINEL, sync_files_on_connection: true, set_page_as_boundary: false, data_source_id: SENTINEL, connecting_new_account: false, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:scope] = scope if scope != SENTINEL
@@ -452,6 +459,8 @@ module Carbon
       _body[:salesforce_domain] = salesforce_domain if salesforce_domain != SENTINEL
       _body[:sync_files_on_connection] = sync_files_on_connection if sync_files_on_connection != SENTINEL
       _body[:set_page_as_boundary] = set_page_as_boundary if set_page_as_boundary != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      _body[:connecting_new_account] = connecting_new_account if connecting_new_account != SENTINEL
       o_auth_url_request = _body
       api_response = get_oauth_url_with_http_info_impl(o_auth_url_request, extra)
       api_response.data
@@ -459,6 +468,11 @@ module Carbon
 
     # Get Oauth Url
     #
+    # This endpoint can be used to generate the following URLs
+    # - An OAuth URL for OAuth based connectors
+    # - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the
+    # success state.
+    #
     # @param service [DataSourceType] 
     # @param tags [Object] 
     # @param scope [String] 
@@ -474,11 +488,13 @@ module Carbon
     # @param prepend_filename_to_chunks [Boolean] 
     # @param max_items_per_chunk [Integer] 
     # @param salesforce_domain [String] 
-    # @param sync_files_on_connection [Boolean] 
+    # @param sync_files_on_connection [Boolean] Used to specify whether Carbon should attempt to sync all your files automatically when authorization is complete. This is only supported for a subset of connectors and will be ignored for the rest. Supported connectors: Intercom, Zendesk, Gitbook, Confluence, Salesforce, Freshdesk
     # @param set_page_as_boundary [Boolean] 
+    # @param data_source_id [Integer] Used to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.
+    # @param connecting_new_account [Boolean] Used to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.
     # @param body [OAuthURLRequest] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_oauth_url_with_http_info(service:, tags: SENTINEL, scope: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', zendesk_subdomain: SENTINEL, microsoft_tenant: SENTINEL, sharepoint_site_name: SENTINEL, confluence_subdomain: SENTINEL, generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, salesforce_domain: SENTINEL, sync_files_on_connection: true, set_page_as_boundary: false, extra: {})
+    def get_oauth_url_with_http_info(service:, tags: SENTINEL, scope: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', zendesk_subdomain: SENTINEL, microsoft_tenant: SENTINEL, sharepoint_site_name: SENTINEL, confluence_subdomain: SENTINEL, generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, salesforce_domain: SENTINEL, sync_files_on_connection: true, set_page_as_boundary: false, data_source_id: SENTINEL, connecting_new_account: false, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:scope] = scope if scope != SENTINEL
@@ -497,23 +513,27 @@ module Carbon
       _body[:salesforce_domain] = salesforce_domain if salesforce_domain != SENTINEL
       _body[:sync_files_on_connection] = sync_files_on_connection if sync_files_on_connection != SENTINEL
       _body[:set_page_as_boundary] = set_page_as_boundary if set_page_as_boundary != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      _body[:connecting_new_account] = connecting_new_account if connecting_new_account != SENTINEL
       o_auth_url_request = _body
       get_oauth_url_with_http_info_impl(o_auth_url_request, extra)
     end
 
     # Get Oauth Url
+    # This endpoint can be used to generate the following URLs - An OAuth URL for OAuth based connectors - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the success state.
     # @param o_auth_url_request [OAuthURLRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [Object]
+    # @return [OuthURLResponse]
     private def get_oauth_url_impl(o_auth_url_request, opts = {})
       data, _status_code, _headers = get_oauth_url_with_http_info(o_auth_url_request, opts)
       data
     end
 
     # Get Oauth Url
+    # This endpoint can be used to generate the following URLs - An OAuth URL for OAuth based connectors - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the success state.
     # @param o_auth_url_request [OAuthURLRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [APIResponse] data is Object, status code, headers and response
+    # @return [APIResponse] data is OuthURLResponse, status code, headers and response
     private def get_oauth_url_with_http_info_impl(o_auth_url_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: IntegrationsApi.get_oauth_url ...'
@@ -545,7 +565,7 @@ module Carbon
       post_body = opts[:debug_body] || @api_client.object_to_http_body(o_auth_url_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'Object'
+      return_type = opts[:debug_return_type] || 'OuthURLResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['accessToken', 'apiKey', 'customerId']
@@ -787,8 +807,10 @@ module Carbon
     # After connecting your Outlook account, you can use this endpoint to list all of your folders on outlook. This includes 
     # both system folders like "inbox" and user created folders.
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_folders(extra: {})
+    def list_folders(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       api_response = list_folders_with_http_info_impl(extra)
       api_response.data
     end
@@ -798,14 +820,17 @@ module Carbon
     # After connecting your Outlook account, you can use this endpoint to list all of your folders on outlook. This includes 
     # both system folders like "inbox" and user created folders.
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_folders_with_http_info(extra: {})
+    def list_folders_with_http_info(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       list_folders_with_http_info_impl(extra)
     end
 
     # Outlook Folders
     # After connecting your Outlook account, you can use this endpoint to list all of your folders on outlook. This includes  both system folders like \"inbox\" and user created folders.
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [Object]
     private def list_folders_impl(opts = {})
       data, _status_code, _headers = list_folders_with_http_info(opts)
@@ -815,6 +840,7 @@ module Carbon
     # Outlook Folders
     # After connecting your Outlook account, you can use this endpoint to list all of your folders on outlook. This includes  both system folders like \"inbox\" and user created folders.
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [APIResponse] data is Object, status code, headers and response
     private def list_folders_with_http_info_impl(opts = {})
       if @api_client.config.debugging
@@ -825,6 +851,7 @@ module Carbon
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'data_source_id'] = opts[:'data_source_id'] if !opts[:'data_source_id'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -952,8 +979,10 @@ module Carbon
     # After connecting your Gmail account, you can use this endpoint to list all of your labels. User created labels
     # will have the type "user" and Gmail's default labels will have the type "system"
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_labels(extra: {})
+    def list_labels(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       api_response = list_labels_with_http_info_impl(extra)
       api_response.data
     end
@@ -963,14 +992,17 @@ module Carbon
     # After connecting your Gmail account, you can use this endpoint to list all of your labels. User created labels
     # will have the type "user" and Gmail's default labels will have the type "system"
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_labels_with_http_info(extra: {})
+    def list_labels_with_http_info(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       list_labels_with_http_info_impl(extra)
     end
 
     # Gmail Labels
     # After connecting your Gmail account, you can use this endpoint to list all of your labels. User created labels will have the type \"user\" and Gmail's default labels will have the type \"system\"
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [Object]
     private def list_labels_impl(opts = {})
       data, _status_code, _headers = list_labels_with_http_info(opts)
@@ -980,6 +1012,7 @@ module Carbon
     # Gmail Labels
     # After connecting your Gmail account, you can use this endpoint to list all of your labels. User created labels will have the type \"user\" and Gmail's default labels will have the type \"system\"
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [APIResponse] data is Object, status code, headers and response
     private def list_labels_with_http_info_impl(opts = {})
       if @api_client.config.debugging
@@ -990,6 +1023,7 @@ module Carbon
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'data_source_id'] = opts[:'data_source_id'] if !opts[:'data_source_id'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1031,8 +1065,10 @@ module Carbon
     # After connecting your Outlook account, you can use this endpoint to list all of your categories on outlook. We currently
     # support listing up to 250 categories.
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_outlook_categories(extra: {})
+    def list_outlook_categories(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       api_response = list_outlook_categories_with_http_info_impl(extra)
       api_response.data
     end
@@ -1042,14 +1078,17 @@ module Carbon
     # After connecting your Outlook account, you can use this endpoint to list all of your categories on outlook. We currently
     # support listing up to 250 categories.
     #
+    # @param data_source_id [Integer] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def list_outlook_categories_with_http_info(extra: {})
+    def list_outlook_categories_with_http_info(data_source_id: SENTINEL, extra: {})
+      extra[:data_source_id] = data_source_id if data_source_id != SENTINEL
       list_outlook_categories_with_http_info_impl(extra)
     end
 
     # Outlook Categories
     # After connecting your Outlook account, you can use this endpoint to list all of your categories on outlook. We currently support listing up to 250 categories.
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [Object]
     private def list_outlook_categories_impl(opts = {})
       data, _status_code, _headers = list_outlook_categories_with_http_info(opts)
@@ -1059,6 +1098,7 @@ module Carbon
     # Outlook Categories
     # After connecting your Outlook account, you can use this endpoint to list all of your categories on outlook. We currently support listing up to 250 categories.
     # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :data_source_id 
     # @return [APIResponse] data is Object, status code, headers and response
     private def list_outlook_categories_with_http_info_impl(opts = {})
       if @api_client.config.debugging
@@ -1069,6 +1109,7 @@ module Carbon
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'data_source_id'] = opts[:'data_source_id'] if !opts[:'data_source_id'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -1678,9 +1719,10 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param generate_sparse_vectors [Boolean] 
     # @param prepend_filename_to_chunks [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [GmailSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_gmail(filters:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, extra: {})
+    def sync_gmail(filters:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:filters] = filters if filters != SENTINEL
@@ -1690,6 +1732,7 @@ module Carbon
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:generate_sparse_vectors] = generate_sparse_vectors if generate_sparse_vectors != SENTINEL
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       gmail_sync_input = _body
       api_response = sync_gmail_with_http_info_impl(gmail_sync_input, extra)
       api_response.data
@@ -1756,9 +1799,10 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param generate_sparse_vectors [Boolean] 
     # @param prepend_filename_to_chunks [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [GmailSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_gmail_with_http_info(filters:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, extra: {})
+    def sync_gmail_with_http_info(filters:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:filters] = filters if filters != SENTINEL
@@ -1768,6 +1812,7 @@ module Carbon
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:generate_sparse_vectors] = generate_sparse_vectors if generate_sparse_vectors != SENTINEL
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       gmail_sync_input = _body
       sync_gmail_with_http_info_impl(gmail_sync_input, extra)
     end
@@ -1913,9 +1958,10 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param generate_sparse_vectors [Boolean] 
     # @param prepend_filename_to_chunks [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [OutlookSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_outlook(filters:, tags: SENTINEL, folder: 'Inbox', chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, extra: {})
+    def sync_outlook(filters:, tags: SENTINEL, folder: 'Inbox', chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:folder] = folder if folder != SENTINEL
@@ -1926,6 +1972,7 @@ module Carbon
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:generate_sparse_vectors] = generate_sparse_vectors if generate_sparse_vectors != SENTINEL
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       outlook_sync_input = _body
       api_response = sync_outlook_with_http_info_impl(outlook_sync_input, extra)
       api_response.data
@@ -2003,9 +2050,10 @@ module Carbon
     # @param embedding_model [EmbeddingGenerators] 
     # @param generate_sparse_vectors [Boolean] 
     # @param prepend_filename_to_chunks [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [OutlookSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_outlook_with_http_info(filters:, tags: SENTINEL, folder: 'Inbox', chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, extra: {})
+    def sync_outlook_with_http_info(filters:, tags: SENTINEL, folder: 'Inbox', chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:folder] = folder if folder != SENTINEL
@@ -2016,6 +2064,7 @@ module Carbon
       _body[:embedding_model] = embedding_model if embedding_model != SENTINEL
       _body[:generate_sparse_vectors] = generate_sparse_vectors if generate_sparse_vectors != SENTINEL
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       outlook_sync_input = _body
       sync_outlook_with_http_info_impl(outlook_sync_input, extra)
     end
@@ -2225,9 +2274,10 @@ module Carbon
     # @param prepend_filename_to_chunks [Boolean] 
     # @param max_items_per_chunk [Integer] 
     # @param set_page_as_boundary [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [S3FileSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_s3_files(ids:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, set_page_as_boundary: false, extra: {})
+    def sync_s3_files(ids:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, set_page_as_boundary: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:ids] = ids if ids != SENTINEL
@@ -2239,6 +2289,7 @@ module Carbon
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
       _body[:max_items_per_chunk] = max_items_per_chunk if max_items_per_chunk != SENTINEL
       _body[:set_page_as_boundary] = set_page_as_boundary if set_page_as_boundary != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       s3_file_sync_input = _body
       api_response = sync_s3_files_with_http_info_impl(s3_file_sync_input, extra)
       api_response.data
@@ -2260,9 +2311,10 @@ module Carbon
     # @param prepend_filename_to_chunks [Boolean] 
     # @param max_items_per_chunk [Integer] 
     # @param set_page_as_boundary [Boolean] 
+    # @param data_source_id [Integer] 
     # @param body [S3FileSyncInput] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def sync_s3_files_with_http_info(ids:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, set_page_as_boundary: false, extra: {})
+    def sync_s3_files_with_http_info(ids:, tags: SENTINEL, chunk_size: 1500, chunk_overlap: 20, skip_embedding_generation: false, embedding_model: 'OPENAI', generate_sparse_vectors: false, prepend_filename_to_chunks: false, max_items_per_chunk: SENTINEL, set_page_as_boundary: false, data_source_id: SENTINEL, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:ids] = ids if ids != SENTINEL
@@ -2274,6 +2326,7 @@ module Carbon
       _body[:prepend_filename_to_chunks] = prepend_filename_to_chunks if prepend_filename_to_chunks != SENTINEL
       _body[:max_items_per_chunk] = max_items_per_chunk if max_items_per_chunk != SENTINEL
       _body[:set_page_as_boundary] = set_page_as_boundary if set_page_as_boundary != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
       s3_file_sync_input = _body
       sync_s3_files_with_http_info_impl(s3_file_sync_input, extra)
     end