carbon_ruby_sdk 0.2.42 → 0.2.43

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cb19d4bb87096e93a501f8532b550859c7706bc52d16416b36e2298a59deb25
-  data.tar.gz: c7efd65f094791724b6f0dcd3ab154a95c0f3f47e4b1acee99de5bba6119a048
+  metadata.gz: '0041088eca440b5e23106b5a61b6631c6bbde015033004d3c84ed205a1f8c3dc'
+  data.tar.gz: d8f21fbc6d1ef0183689fb980f05da068930ae611a06d83464411eb708316099
 SHA512:
-  metadata.gz: 01fc784420d00d6fbd842c89490f69e83170045b5a448e3a58faf2b46e48035e0cc18ad410e48c2e410fdb56cf824d8b9a6a2bd8993f23bcc42176646eaa69cd
-  data.tar.gz: 888a7225635431d0232a823d6801a99433632794cf7a2e7c344503e772ddda3356497d58316a4dae0e62e4e4f72a1a039a8ba66b1db83f6376cd7cb4cdff7fc5
+  metadata.gz: 5ab2fe2c38087f093e086a2a9127acee8e9c7fcfb40cf763eee594d128579dbb02b0a33045ba9bf5bbf6c5c5b2ae382d2e01500c6a95df2cc85f7c0f7ad3e0da
+  data.tar.gz: 83c6428340b06c799b908b818172ad17b5bc3b78b3016374572ac64211f23d78a7357418ddbbc57f61a5842654ced1da1dddf409117bdc40982bc469a1ee4113

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    carbon_ruby_sdk (0.2.42)
+    carbon_ruby_sdk (0.2.43)
       faraday (>= 1.0.1, < 3.0)
       faraday-multipart (~> 1.0, >= 1.0.4)
 
@@ -49,7 +49,7 @@ GEM
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.1)
+    rspec-core (3.13.2)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)

data/README.md

@@ -6,7 +6,7 @@
 
 Connect external data to LLMs, no matter the source.
 
-[![npm](https://img.shields.io/badge/gem-v0.2.42-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.42)
+[![npm](https://img.shields.io/badge/gem-v0.2.43-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.43)
 
 </div>
 
@@ -28,7 +28,9 @@ Connect external data to LLMs, no matter the source.
   * [`carbon.crm.get_leads`](#carboncrmget_leads)
   * [`carbon.crm.get_opportunities`](#carboncrmget_opportunities)
   * [`carbon.crm.get_opportunity`](#carboncrmget_opportunity)
+  * [`carbon.data_sources.add_tags`](#carbondata_sourcesadd_tags)
   * [`carbon.data_sources.query_user_data_sources`](#carbondata_sourcesquery_user_data_sources)
+  * [`carbon.data_sources.remove_tags`](#carbondata_sourcesremove_tags)
   * [`carbon.data_sources.revoke_access_token`](#carbondata_sourcesrevoke_access_token)
   * [`carbon.embeddings.get_documents`](#carbonembeddingsget_documents)
   * [`carbon.embeddings.get_embeddings_and_chunks`](#carbonembeddingsget_embeddings_and_chunks)
@@ -92,6 +94,7 @@ Connect external data to LLMs, no matter the source.
   * [`carbon.users.list`](#carbonuserslist)
   * [`carbon.users.toggle_user_features`](#carbonuserstoggle_user_features)
   * [`carbon.users.update_users`](#carbonusersupdate_users)
+  * [`carbon.users.who_am_i`](#carbonuserswho_am_i)
   * [`carbon.utilities.fetch_urls`](#carbonutilitiesfetch_urls)
   * [`carbon.utilities.fetch_webpage`](#carbonutilitiesfetch_webpage)
   * [`carbon.utilities.fetch_youtube_transcripts`](#carbonutilitiesfetch_youtube_transcripts)
@@ -115,7 +118,7 @@ Connect external data to LLMs, no matter the source.
 Add to Gemfile:
 
 ```ruby
-gem 'carbon_ruby_sdk', '~> 0.2.42'
+gem 'carbon_ruby_sdk', '~> 0.2.43'
 ```
 
 ## Getting Started<a id="getting-started"></a>
@@ -532,6 +535,37 @@ p result
 ---
 
 
+### `carbon.data_sources.add_tags`<a id="carbondata_sourcesadd_tags"></a>
+
+Add Data Source Tags
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = carbon.data_sources.add_tags(
+  tags: {},
+  data_source_id: 1,
+)
+p result
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### tags: `Object`<a id="tags-object"></a>
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
+#### 🔄 Return<a id="🔄-return"></a>
+
+[OrganizationUserDataSourceAPI](./lib/carbon_ruby_sdk/models/organization_user_data_source_api.rb)
+
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/data_sources/tags/add` `POST`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `carbon.data_sources.query_user_data_sources`<a id="carbondata_sourcesquery_user_data_sources"></a>
 
 User Data Sources
@@ -572,6 +606,39 @@ p result
 ---
 
 
+### `carbon.data_sources.remove_tags`<a id="carbondata_sourcesremove_tags"></a>
+
+Remove Data Source Tags
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = carbon.data_sources.remove_tags(
+  data_source_id: 1,
+  tags_to_remove: [],
+  remove_all_tags: false,
+)
+p result
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### data_source_id: `Integer`<a id="data_source_id-integer"></a>
+##### tags_to_remove: Array<`String`><a id="tags_to_remove-array"></a>
+##### remove_all_tags: `Boolean`<a id="remove_all_tags-boolean"></a>
+#### 🔄 Return<a id="🔄-return"></a>
+
+[OrganizationUserDataSourceAPI](./lib/carbon_ruby_sdk/models/organization_user_data_source_api.rb)
+
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/data_sources/tags/remove` `POST`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `carbon.data_sources.revoke_access_token`<a id="carbondata_sourcesrevoke_access_token"></a>
 
 Revoke Access Token
@@ -1569,7 +1636,8 @@ Enable cold storage for the file. If set to true, the file will be moved to cold
 storage after a certain period of inactivity. Default is false.
 
 ##### hot_storage_time_to_live: `Integer`<a id="hot_storage_time_to_live-integer"></a>
-Time in seconds after which the file will be moved to cold storage.
+Time in days after which the file will be moved to cold storage. Must be one of
+[1, 3, 7, 14, 30].
 
 ##### generate_chunks_only: `Boolean`<a id="generate_chunks_only-boolean"></a>
 If this flag is enabled, the file will be chunked and stored with Carbon, but no
@@ -2146,6 +2214,7 @@ result = carbon.integrations.connect_freshdesk(
         "store_file_only" => false,
         "skip_file_processing" => false,
     },
+  data_source_tags: {},
 )
 p result
 ```
@@ -2168,6 +2237,10 @@ Enabling this flag will fetch all available content from the source to be listed
 via list items endpoint
 
 ##### file_sync_config: [`FileSyncConfigNullable`](./lib/carbon_ruby_sdk/models/file_sync_config_nullable.rb)<a id="file_sync_config-filesyncconfignullablelibcarbon_ruby_sdkmodelsfile_sync_config_nullablerb"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -2215,6 +2288,7 @@ result = carbon.integrations.connect_gitbook(
         "store_file_only" => false,
         "skip_file_processing" => false,
     },
+  data_source_tags: {},
 )
 p result
 ```
@@ -2237,6 +2311,10 @@ Enabling this flag will fetch all available content from the source to be listed
 via list items endpoint
 
 ##### file_sync_config: [`FileSyncConfigNullable`](./lib/carbon_ruby_sdk/models/file_sync_config_nullable.rb)<a id="file_sync_config-filesyncconfignullablelibcarbon_ruby_sdkmodelsfile_sync_config_nullablerb"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -2282,6 +2360,7 @@ result = carbon.integrations.connect_guru(
         "store_file_only" => false,
         "skip_file_processing" => false,
     },
+  data_source_tags: {},
 )
 p result
 ```
@@ -2304,6 +2383,10 @@ Enabling this flag will fetch all available content from the source to be listed
 via list items endpoint
 
 ##### file_sync_config: [`FileSyncConfigNullable`](./lib/carbon_ruby_sdk/models/file_sync_config_nullable.rb)<a id="file_sync_config-filesyncconfignullablelibcarbon_ruby_sdkmodelsfile_sync_config_nullablerb"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -2338,6 +2421,7 @@ result = carbon.integrations.create_aws_iam_user(
   access_key_secret: "string_example",
   sync_source_items: true,
   endpoint_url: "string_example",
+  data_source_tags: {},
 )
 p result
 ```
@@ -2355,6 +2439,10 @@ You can specify a Digital Ocean endpoint URL to connect a Digital Ocean Space
 through this endpoint. The URL should be of format
 <region>.digitaloceanspaces.com. It's not required for S3 buckets.
 
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [OrganizationUserDataSourceAPI](./lib/carbon_ruby_sdk/models/organization_user_data_source_api.rb)
@@ -2423,6 +2511,7 @@ result = carbon.integrations.get_oauth_url(
         "client_secret" => "client_secret_example",
         "redirect_uri" => "redirect_uri_example",
     },
+  data_source_tags: {},
 )
 p result
 ```
@@ -2496,6 +2585,10 @@ you wish to connect. This email will be used to identify your carbon data
 source.
 
 ##### servicenow_credentials: [`ServiceNowCredentialsNullable`](./lib/carbon_ruby_sdk/models/service_now_credentials_nullable.rb)<a id="servicenow_credentials-servicenowcredentialsnullablelibcarbon_ruby_sdkmodelsservice_now_credentials_nullablerb"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [OuthURLResponse](./lib/carbon_ruby_sdk/models/outh_url_response.rb)
@@ -2864,6 +2957,7 @@ result = carbon.integrations.sync_azure_blob_storage(
   account_name: "string_example",
   account_key: "string_example",
   sync_source_items: true,
+  data_source_tags: {},
 )
 p result
 ```
@@ -2873,6 +2967,10 @@ p result
 ##### account_name: `String`<a id="account_name-string"></a>
 ##### account_key: `String`<a id="account_key-string"></a>
 ##### sync_source_items: `Boolean`<a id="sync_source_items-boolean"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [OrganizationUserDataSourceAPI](./lib/carbon_ruby_sdk/models/organization_user_data_source_api.rb)
@@ -3093,6 +3191,7 @@ result = carbon.integrations.sync_git_hub(
   username: "string_example",
   access_token: "string_example",
   sync_source_items: false,
+  data_source_tags: {},
 )
 p result
 ```
@@ -3105,6 +3204,10 @@ p result
 Enabling this flag will fetch all available content from the source to be listed
 via list items endpoint
 
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -3465,6 +3568,7 @@ result = carbon.integrations.sync_rss_feed(
   generate_sparse_vectors: false,
   prepend_filename_to_chunks: false,
   request_id: "string_example",
+  data_source_tags: {},
 )
 p result
 ```
@@ -3480,6 +3584,10 @@ p result
 ##### generate_sparse_vectors: `Boolean`<a id="generate_sparse_vectors-boolean"></a>
 ##### prepend_filename_to_chunks: `Boolean`<a id="prepend_filename_to_chunks-boolean"></a>
 ##### request_id: `String`<a id="request_id-string"></a>
+##### data_source_tags: `Object`<a id="data_source_tags-object"></a>
+Tags to be associated with the data source. If the data source already has tags
+set, then an upsert will be performed.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [GenericSuccessResponse](./lib/carbon_ruby_sdk/models/generic_success_response.rb)
@@ -3903,6 +4011,30 @@ not set, or if set to -1, then the user will have no limit.
 ---
 
 
+### `carbon.users.who_am_i`<a id="carbonuserswho_am_i"></a>
+
+Me Endpoint
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = carbon.users.who_am_i
+p result
+```
+
+#### 🔄 Return<a id="🔄-return"></a>
+
+[UserResponse](./lib/carbon_ruby_sdk/models/user_response.rb)
+
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/whoami` `GET`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `carbon.utilities.fetch_urls`<a id="carbonutilitiesfetch_urls"></a>
 ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
 

data/lib/carbon_ruby_sdk/api/data_sources_api.rb

@@ -16,6 +16,102 @@ module Carbon
       @api_client = api_client
     end
 
+    # Add Data Source Tags
+    #
+    # @param tags [Object] 
+    # @param data_source_id [Integer] 
+    # @param body [AddDataSourceTagsInput] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def add_tags(tags:, data_source_id:, extra: {})
+      _body = {}
+      _body[:tags] = tags if tags != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      add_data_source_tags_input = _body
+      api_response = add_tags_with_http_info_impl(add_data_source_tags_input, extra)
+      api_response.data
+    end
+
+    # Add Data Source Tags
+    #
+    # @param tags [Object] 
+    # @param data_source_id [Integer] 
+    # @param body [AddDataSourceTagsInput] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def add_tags_with_http_info(tags:, data_source_id:, extra: {})
+      _body = {}
+      _body[:tags] = tags if tags != SENTINEL
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      add_data_source_tags_input = _body
+      add_tags_with_http_info_impl(add_data_source_tags_input, extra)
+    end
+
+    # Add Data Source Tags
+    # @param add_data_source_tags_input [AddDataSourceTagsInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [OrganizationUserDataSourceAPI]
+    private def add_tags_impl(add_data_source_tags_input, opts = {})
+      data, _status_code, _headers = add_tags_with_http_info(add_data_source_tags_input, opts)
+      data
+    end
+
+    # Add Data Source Tags
+    # @param add_data_source_tags_input [AddDataSourceTagsInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [APIResponse] data is OrganizationUserDataSourceAPI, status code, headers and response
+    private def add_tags_with_http_info_impl(add_data_source_tags_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DataSourcesApi.add_tags ...'
+      end
+      # verify the required parameter 'add_data_source_tags_input' is set
+      if @api_client.config.client_side_validation && add_data_source_tags_input.nil?
+        fail ArgumentError, "Missing the required parameter 'add_data_source_tags_input' when calling DataSourcesApi.add_tags"
+      end
+      # resource path
+      local_var_path = '/data_sources/tags/add'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(add_data_source_tags_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'OrganizationUserDataSourceAPI'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['accessToken', 'apiKey', 'customerId']
+
+      new_options = opts.merge(
+        :operation => :"DataSourcesApi.add_tags",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers, response = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DataSourcesApi#add_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      APIResponse::new(data, status_code, headers, response)
+    end
+
+
     # User Data Sources
     #
     # @param pagination [Pagination] 
@@ -120,6 +216,106 @@ module Carbon
     end
 
 
+    # Remove Data Source Tags
+    #
+    # @param data_source_id [Integer] 
+    # @param tags_to_remove [Array<String>] 
+    # @param remove_all_tags [Boolean] 
+    # @param body [RemoveDataSourceTagsInput] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def remove_tags(data_source_id:, tags_to_remove: SENTINEL, remove_all_tags: false, extra: {})
+      _body = {}
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      _body[:tags_to_remove] = tags_to_remove if tags_to_remove != SENTINEL
+      _body[:remove_all_tags] = remove_all_tags if remove_all_tags != SENTINEL
+      remove_data_source_tags_input = _body
+      api_response = remove_tags_with_http_info_impl(remove_data_source_tags_input, extra)
+      api_response.data
+    end
+
+    # Remove Data Source Tags
+    #
+    # @param data_source_id [Integer] 
+    # @param tags_to_remove [Array<String>] 
+    # @param remove_all_tags [Boolean] 
+    # @param body [RemoveDataSourceTagsInput] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def remove_tags_with_http_info(data_source_id:, tags_to_remove: SENTINEL, remove_all_tags: false, extra: {})
+      _body = {}
+      _body[:data_source_id] = data_source_id if data_source_id != SENTINEL
+      _body[:tags_to_remove] = tags_to_remove if tags_to_remove != SENTINEL
+      _body[:remove_all_tags] = remove_all_tags if remove_all_tags != SENTINEL
+      remove_data_source_tags_input = _body
+      remove_tags_with_http_info_impl(remove_data_source_tags_input, extra)
+    end
+
+    # Remove Data Source Tags
+    # @param remove_data_source_tags_input [RemoveDataSourceTagsInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [OrganizationUserDataSourceAPI]
+    private def remove_tags_impl(remove_data_source_tags_input, opts = {})
+      data, _status_code, _headers = remove_tags_with_http_info(remove_data_source_tags_input, opts)
+      data
+    end
+
+    # Remove Data Source Tags
+    # @param remove_data_source_tags_input [RemoveDataSourceTagsInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [APIResponse] data is OrganizationUserDataSourceAPI, status code, headers and response
+    private def remove_tags_with_http_info_impl(remove_data_source_tags_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DataSourcesApi.remove_tags ...'
+      end
+      # verify the required parameter 'remove_data_source_tags_input' is set
+      if @api_client.config.client_side_validation && remove_data_source_tags_input.nil?
+        fail ArgumentError, "Missing the required parameter 'remove_data_source_tags_input' when calling DataSourcesApi.remove_tags"
+      end
+      # resource path
+      local_var_path = '/data_sources/tags/remove'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(remove_data_source_tags_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'OrganizationUserDataSourceAPI'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['accessToken', 'apiKey', 'customerId']
+
+      new_options = opts.merge(
+        :operation => :"DataSourcesApi.remove_tags",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers, response = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DataSourcesApi#remove_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      APIResponse::new(data, status_code, headers, response)
+    end
+
+
     # Revoke Access Token
     #
     # @param data_source_id [Integer] 

data/lib/carbon_ruby_sdk/api/files_api.rb

@@ -1378,7 +1378,7 @@ module Carbon
     # @param media_type [FileContentTypesNullable] The media type of the file. If not provided, it will be inferred from the file extension.
     # @param split_rows [Boolean] Whether to split tabular rows into chunks. Currently only valid for CSV, TSV, and XLSX files.
     # @param enable_cold_storage [Boolean] Enable cold storage for the file. If set to true, the file will be moved to cold storage after a certain period of inactivity. Default is false.
-    # @param hot_storage_time_to_live [Integer] Time in seconds after which the file will be moved to cold storage.
+    # @param hot_storage_time_to_live [Integer] Time in days after which the file will be moved to cold storage. Must be one of [1, 3, 7, 14, 30].
     # @param generate_chunks_only [Boolean] If this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
     # @param store_file_only [Boolean] If this flag is enabled, the file will be stored with Carbon, but no processing will be done.
     # @param body [BodyCreateUploadFileUploadfilePost] 
@@ -1455,7 +1455,7 @@ module Carbon
     # @param media_type [FileContentTypesNullable] The media type of the file. If not provided, it will be inferred from the file extension.
     # @param split_rows [Boolean] Whether to split tabular rows into chunks. Currently only valid for CSV, TSV, and XLSX files.
     # @param enable_cold_storage [Boolean] Enable cold storage for the file. If set to true, the file will be moved to cold storage after a certain period of inactivity. Default is false.
-    # @param hot_storage_time_to_live [Integer] Time in seconds after which the file will be moved to cold storage.
+    # @param hot_storage_time_to_live [Integer] Time in days after which the file will be moved to cold storage. Must be one of [1, 3, 7, 14, 30].
     # @param generate_chunks_only [Boolean] If this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
     # @param store_file_only [Boolean] If this flag is enabled, the file will be stored with Carbon, but no processing will be done.
     # @param body [BodyCreateUploadFileUploadfilePost] 
@@ -1507,7 +1507,7 @@ module Carbon
     # @option opts [FileContentTypesNullable] :media_type The media type of the file. If not provided, it will be inferred from the file extension.
     # @option opts [Boolean] :split_rows Whether to split tabular rows into chunks. Currently only valid for CSV, TSV, and XLSX files. (default to false)
     # @option opts [Boolean] :enable_cold_storage Enable cold storage for the file. If set to true, the file will be moved to cold storage after a certain period of inactivity. Default is false. (default to false)
-    # @option opts [Integer] :hot_storage_time_to_live Time in seconds after which the file will be moved to cold storage.
+    # @option opts [Integer] :hot_storage_time_to_live Time in days after which the file will be moved to cold storage. Must be one of [1, 3, 7, 14, 30].
     # @option opts [Boolean] :generate_chunks_only If this flag is enabled, the file will be chunked and stored with Carbon,             but no embeddings will be generated. This overrides the skip_embedding_generation flag. (default to false)
     # @option opts [Boolean] :store_file_only If this flag is enabled, the file will be stored with Carbon, but no processing will be done. (default to false)
     # @return [UserFile]
@@ -1537,7 +1537,7 @@ module Carbon
     # @option opts [FileContentTypesNullable] :media_type The media type of the file. If not provided, it will be inferred from the file extension.
     # @option opts [Boolean] :split_rows Whether to split tabular rows into chunks. Currently only valid for CSV, TSV, and XLSX files. (default to false)
     # @option opts [Boolean] :enable_cold_storage Enable cold storage for the file. If set to true, the file will be moved to cold storage after a certain period of inactivity. Default is false. (default to false)
-    # @option opts [Integer] :hot_storage_time_to_live Time in seconds after which the file will be moved to cold storage.
+    # @option opts [Integer] :hot_storage_time_to_live Time in days after which the file will be moved to cold storage. Must be one of [1, 3, 7, 14, 30].
     # @option opts [Boolean] :generate_chunks_only If this flag is enabled, the file will be chunked and stored with Carbon,             but no embeddings will be generated. This overrides the skip_embedding_generation flag. (default to false)
     # @option opts [Boolean] :store_file_only If this flag is enabled, the file will be stored with Carbon, but no processing will be done. (default to false)
     # @return [APIResponse] data is UserFile, status code, headers and response