carbon_ruby_sdk 0.2.42 → 0.2.43

data/lib/carbon_ruby_sdk/models/remove_data_source_tags_input.rb

@@ -0,0 +1,242 @@
+=begin
+#Carbon
+
+#Connect external data to LLMs, no matter the source.
+
+The version of the OpenAPI document: 1.0.0
+=end
+
+require 'date'
+require 'time'
+
+module Carbon
+  class RemoveDataSourceTagsInput
+    attr_accessor :data_source_id
+
+    attr_accessor :tags_to_remove
+
+    attr_accessor :remove_all_tags
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data_source_id' => :'data_source_id',
+        :'tags_to_remove' => :'tags_to_remove',
+        :'remove_all_tags' => :'remove_all_tags'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'data_source_id' => :'Integer',
+        :'tags_to_remove' => :'Array<String>',
+        :'remove_all_tags' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Carbon::RemoveDataSourceTagsInput` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Carbon::RemoveDataSourceTagsInput`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'data_source_id')
+        self.data_source_id = attributes[:'data_source_id']
+      end
+
+      if attributes.key?(:'tags_to_remove')
+        if (value = attributes[:'tags_to_remove']).is_a?(Array)
+          self.tags_to_remove = value
+        end
+      end
+
+      if attributes.key?(:'remove_all_tags')
+        self.remove_all_tags = attributes[:'remove_all_tags']
+      else
+        self.remove_all_tags = false
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      if @data_source_id.nil?
+        invalid_properties.push('invalid value for "data_source_id", data_source_id cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      return false if @data_source_id.nil?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          data_source_id == o.data_source_id &&
+          tags_to_remove == o.tags_to_remove &&
+          remove_all_tags == o.remove_all_tags
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [data_source_id, tags_to_remove, remove_all_tags].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      new.build_from_hash(attributes)
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      self.class.openapi_types.each_pair do |key, type|
+        if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
+          self.send("#{key}=", nil)
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = Carbon.const_get(type)
+        klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/carbon_ruby_sdk/models/rss_feed_input.rb

@@ -29,6 +29,9 @@ module Carbon
 
     attr_accessor :request_id
 
+    # Tags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
+    attr_accessor :data_source_tags
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -40,7 +43,8 @@ module Carbon
         :'embedding_model' => :'embedding_model',
         :'generate_sparse_vectors' => :'generate_sparse_vectors',
         :'prepend_filename_to_chunks' => :'prepend_filename_to_chunks',
-        :'request_id' => :'request_id'
+        :'request_id' => :'request_id',
+        :'data_source_tags' => :'data_source_tags'
       }
     end
 
@@ -60,7 +64,8 @@ module Carbon
         :'embedding_model' => :'EmbeddingGenerators',
         :'generate_sparse_vectors' => :'Boolean',
         :'prepend_filename_to_chunks' => :'Boolean',
-        :'request_id' => :'String'
+        :'request_id' => :'String',
+        :'data_source_tags' => :'Object'
       }
     end
 
@@ -73,7 +78,7 @@ module Carbon
         :'skip_embedding_generation',
         :'generate_sparse_vectors',
         :'prepend_filename_to_chunks',
-        :'request_id'
+        :'request_id',
       ])
     end
 
@@ -139,6 +144,10 @@ module Carbon
       if attributes.key?(:'request_id')
         self.request_id = attributes[:'request_id']
       end
+
+      if attributes.key?(:'data_source_tags')
+        self.data_source_tags = attributes[:'data_source_tags']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -172,7 +181,8 @@ module Carbon
           embedding_model == o.embedding_model &&
           generate_sparse_vectors == o.generate_sparse_vectors &&
           prepend_filename_to_chunks == o.prepend_filename_to_chunks &&
-          request_id == o.request_id
+          request_id == o.request_id &&
+          data_source_tags == o.data_source_tags
     end
 
     # @see the `==` method
@@ -184,7 +194,7 @@ module Carbon
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [tags, url, chunk_size, chunk_overlap, skip_embedding_generation, embedding_model, generate_sparse_vectors, prepend_filename_to_chunks, request_id].hash
+      [tags, url, chunk_size, chunk_overlap, skip_embedding_generation, embedding_model, generate_sparse_vectors, prepend_filename_to_chunks, request_id, data_source_tags].hash
     end
 
     # Builds the object from hash

data/lib/carbon_ruby_sdk/models/s3_auth_request.rb

@@ -21,13 +21,17 @@ module Carbon
     # 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.
     attr_accessor :endpoint_url
 
+    # Tags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
+    attr_accessor :data_source_tags
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'access_key' => :'access_key',
         :'access_key_secret' => :'access_key_secret',
         :'sync_source_items' => :'sync_source_items',
-        :'endpoint_url' => :'endpoint_url'
+        :'endpoint_url' => :'endpoint_url',
+        :'data_source_tags' => :'data_source_tags'
       }
     end
 
@@ -42,14 +46,15 @@ module Carbon
         :'access_key' => :'String',
         :'access_key_secret' => :'String',
         :'sync_source_items' => :'Boolean',
-        :'endpoint_url' => :'String'
+        :'endpoint_url' => :'String',
+        :'data_source_tags' => :'Object'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'endpoint_url'
+        :'endpoint_url',
       ])
     end
 
@@ -85,6 +90,10 @@ module Carbon
       if attributes.key?(:'endpoint_url')
         self.endpoint_url = attributes[:'endpoint_url']
       end
+
+      if attributes.key?(:'data_source_tags')
+        self.data_source_tags = attributes[:'data_source_tags']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -118,7 +127,8 @@ module Carbon
           access_key == o.access_key &&
           access_key_secret == o.access_key_secret &&
           sync_source_items == o.sync_source_items &&
-          endpoint_url == o.endpoint_url
+          endpoint_url == o.endpoint_url &&
+          data_source_tags == o.data_source_tags
     end
 
     # @see the `==` method
@@ -130,7 +140,7 @@ module Carbon
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [access_key, access_key_secret, sync_source_items, endpoint_url].hash
+      [access_key, access_key_secret, sync_source_items, endpoint_url, data_source_tags].hash
     end
 
     # Builds the object from hash

data/lib/carbon_ruby_sdk/models/sync_options.rb

@@ -48,6 +48,9 @@ module Carbon
     # Automatically open source file picker after the OAuth flow is complete. This flag is currently supported by         BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT. It will be ignored for other data sources.
     attr_accessor :automatically_open_file_picker
 
+    # Tags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
+    attr_accessor :data_source_tags
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -66,7 +69,8 @@ module Carbon
         :'sync_source_items' => :'sync_source_items',
         :'incremental_sync' => :'incremental_sync',
         :'file_sync_config' => :'file_sync_config',
-        :'automatically_open_file_picker' => :'automatically_open_file_picker'
+        :'automatically_open_file_picker' => :'automatically_open_file_picker',
+        :'data_source_tags' => :'data_source_tags'
       }
     end
 
@@ -93,7 +97,8 @@ module Carbon
         :'sync_source_items' => :'Boolean',
         :'incremental_sync' => :'Boolean',
         :'file_sync_config' => :'FileSyncConfigNullable',
-        :'automatically_open_file_picker' => :'Boolean'
+        :'automatically_open_file_picker' => :'Boolean',
+        :'data_source_tags' => :'Object'
       }
     end
 
@@ -111,7 +116,7 @@ module Carbon
         :'sync_files_on_connection',
         :'request_id',
         :'file_sync_config',
-        :'automatically_open_file_picker'
+        :'automatically_open_file_picker',
       ])
     end
 
@@ -215,6 +220,10 @@ module Carbon
       if attributes.key?(:'automatically_open_file_picker')
         self.automatically_open_file_picker = attributes[:'automatically_open_file_picker']
       end
+
+      if attributes.key?(:'data_source_tags')
+        self.data_source_tags = attributes[:'data_source_tags']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -250,7 +259,8 @@ module Carbon
           sync_source_items == o.sync_source_items &&
           incremental_sync == o.incremental_sync &&
           file_sync_config == o.file_sync_config &&
-          automatically_open_file_picker == o.automatically_open_file_picker
+          automatically_open_file_picker == o.automatically_open_file_picker &&
+          data_source_tags == o.data_source_tags
     end
 
     # @see the `==` method
@@ -262,7 +272,7 @@ module Carbon
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [tags, chunk_size, chunk_overlap, skip_embedding_generation, embedding_model, generate_sparse_vectors, prepend_filename_to_chunks, max_items_per_chunk, sync_files_on_connection, set_page_as_boundary, request_id, enable_file_picker, sync_source_items, incremental_sync, file_sync_config, automatically_open_file_picker].hash
+      [tags, chunk_size, chunk_overlap, skip_embedding_generation, embedding_model, generate_sparse_vectors, prepend_filename_to_chunks, max_items_per_chunk, sync_files_on_connection, set_page_as_boundary, request_id, enable_file_picker, sync_source_items, incremental_sync, file_sync_config, automatically_open_file_picker, data_source_tags].hash
     end
 
     # Builds the object from hash

data/lib/carbon_ruby_sdk/models/user_response.rb

@@ -49,6 +49,8 @@ module Carbon
 
     attr_accessor :auto_sync_enabled_sources
 
+    attr_accessor :connector_settings
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -70,7 +72,8 @@ module Carbon
         :'unique_file_tags' => :'unique_file_tags',
         :'enabled_features' => :'enabled_features',
         :'custom_limits' => :'custom_limits',
-        :'auto_sync_enabled_sources' => :'auto_sync_enabled_sources'
+        :'auto_sync_enabled_sources' => :'auto_sync_enabled_sources',
+        :'connector_settings' => :'connector_settings'
       }
     end
 
@@ -100,7 +103,8 @@ module Carbon
         :'unique_file_tags' => :'Array<Object>',
         :'enabled_features' => :'Object',
         :'custom_limits' => :'Object',
-        :'auto_sync_enabled_sources' => :'Array<Object>'
+        :'auto_sync_enabled_sources' => :'Array<Object>',
+        :'connector_settings' => :'Object'
       }
     end
 
@@ -206,6 +210,10 @@ module Carbon
           self.auto_sync_enabled_sources = value
         end
       end
+
+      if attributes.key?(:'connector_settings')
+        self.connector_settings = attributes[:'connector_settings']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -280,6 +288,10 @@ module Carbon
         invalid_properties.push('invalid value for "auto_sync_enabled_sources", auto_sync_enabled_sources cannot be nil.')
       end
 
+      if @connector_settings.nil?
+        invalid_properties.push('invalid value for "connector_settings", connector_settings cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -303,6 +315,7 @@ module Carbon
       return false if @unique_file_tags.nil?
       return false if @custom_limits.nil?
       return false if @auto_sync_enabled_sources.nil?
+      return false if @connector_settings.nil?
       true
     end
 
@@ -329,7 +342,8 @@ module Carbon
           unique_file_tags == o.unique_file_tags &&
           enabled_features == o.enabled_features &&
           custom_limits == o.custom_limits &&
-          auto_sync_enabled_sources == o.auto_sync_enabled_sources
+          auto_sync_enabled_sources == o.auto_sync_enabled_sources &&
+          connector_settings == o.connector_settings
     end
 
     # @see the `==` method
@@ -341,7 +355,7 @@ module Carbon
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, organization_id, organization_supplied_user_id, created_at, updated_at, deleted_at, num_files_synced, num_characters_synced, num_tokens_synced, aggregate_file_size, aggregate_num_characters, aggregate_num_tokens, aggregate_num_embeddings, aggregate_num_files_by_source, aggregate_num_files_by_file_format, unique_file_tags, enabled_features, custom_limits, auto_sync_enabled_sources].hash
+      [id, organization_id, organization_supplied_user_id, created_at, updated_at, deleted_at, num_files_synced, num_characters_synced, num_tokens_synced, aggregate_file_size, aggregate_num_characters, aggregate_num_tokens, aggregate_num_embeddings, aggregate_num_files_by_source, aggregate_num_files_by_file_format, unique_file_tags, enabled_features, custom_limits, auto_sync_enabled_sources, connector_settings].hash
     end
 
     # Builds the object from hash

data/lib/carbon_ruby_sdk/models/white_labeling_response.rb

@@ -17,12 +17,15 @@ module Carbon
 
     attr_accessor :custom_limits
 
+    attr_accessor :connector_settings
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'remove_branding' => :'remove_branding',
         :'integrations' => :'integrations',
-        :'custom_limits' => :'custom_limits'
+        :'custom_limits' => :'custom_limits',
+        :'connector_settings' => :'connector_settings'
       }
     end
 
@@ -36,7 +39,8 @@ module Carbon
       {
         :'remove_branding' => :'Boolean',
         :'integrations' => :'Object',
-        :'custom_limits' => :'Object'
+        :'custom_limits' => :'Object',
+        :'connector_settings' => :'Object'
       }
     end
 
@@ -72,6 +76,10 @@ module Carbon
       if attributes.key?(:'custom_limits')
         self.custom_limits = attributes[:'custom_limits']
       end
+
+      if attributes.key?(:'connector_settings')
+        self.connector_settings = attributes[:'connector_settings']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -90,6 +98,10 @@ module Carbon
         invalid_properties.push('invalid value for "custom_limits", custom_limits cannot be nil.')
       end
 
+      if @connector_settings.nil?
+        invalid_properties.push('invalid value for "connector_settings", connector_settings cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -99,6 +111,7 @@ module Carbon
       return false if @remove_branding.nil?
       return false if @integrations.nil?
       return false if @custom_limits.nil?
+      return false if @connector_settings.nil?
       true
     end
 
@@ -109,7 +122,8 @@ module Carbon
       self.class == o.class &&
           remove_branding == o.remove_branding &&
           integrations == o.integrations &&
-          custom_limits == o.custom_limits
+          custom_limits == o.custom_limits &&
+          connector_settings == o.connector_settings
     end
 
     # @see the `==` method
@@ -121,7 +135,7 @@ module Carbon
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [remove_branding, integrations, custom_limits].hash
+      [remove_branding, integrations, custom_limits, connector_settings].hash
     end
 
     # Builds the object from hash

data/lib/carbon_ruby_sdk/version.rb

@@ -7,5 +7,5 @@ The version of the OpenAPI document: 1.0.0
 =end
 
 module Carbon
-  VERSION = '0.2.42'
+  VERSION = '0.2.43'
 end

data/lib/carbon_ruby_sdk.rb

@@ -21,6 +21,7 @@ require 'carbon_ruby_sdk/models/account_response'
 require 'carbon_ruby_sdk/models/accounts_order_by'
 require 'carbon_ruby_sdk/models/accounts_order_by_nullable'
 require 'carbon_ruby_sdk/models/accounts_request'
+require 'carbon_ruby_sdk/models/add_data_source_tags_input'
 require 'carbon_ruby_sdk/models/add_webhook_props'
 require 'carbon_ruby_sdk/models/address'
 require 'carbon_ruby_sdk/models/authentication_property'
@@ -205,6 +206,7 @@ require 'carbon_ruby_sdk/models/rss_feed_input'
 require 'carbon_ruby_sdk/models/rank_property'
 require 'carbon_ruby_sdk/models/raw_text_input'
 require 'carbon_ruby_sdk/models/raw_transcript_property_inner_value'
+require 'carbon_ruby_sdk/models/remove_data_source_tags_input'
 require 'carbon_ruby_sdk/models/rerank_params'
 require 'carbon_ruby_sdk/models/rerank_params_nullable'
 require 'carbon_ruby_sdk/models/resync_file_query_input'

data/spec/api/data_sources_api_spec.rb

@@ -26,6 +26,17 @@ describe 'DataSourcesApi' do
     end
   end
 
+  # unit tests for add_tags
+  # Add Data Source Tags
+  # @param add_data_source_tags_input 
+  # @param [Hash] opts the optional parameters
+  # @return [OrganizationUserDataSourceAPI]
+  describe 'add_tags test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
   # unit tests for query_user_data_sources
   # User Data Sources
   # @param organization_user_data_source_query_input 
@@ -37,6 +48,17 @@ describe 'DataSourcesApi' do
     end
   end
 
+  # unit tests for remove_tags
+  # Remove Data Source Tags
+  # @param remove_data_source_tags_input 
+  # @param [Hash] opts the optional parameters
+  # @return [OrganizationUserDataSourceAPI]
+  describe 'remove_tags test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
   # unit tests for revoke_access_token
   # Revoke Access Token
   # @param revoke_access_token_input 

data/spec/api/files_api_spec.rb

@@ -185,7 +185,7 @@ describe 'FilesApi' do
   # @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.
   # @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.
-  # @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.
   # @option opts [Boolean] :store_file_only If this flag is enabled, the file will be stored with Carbon, but no processing will be done.
   # @return [UserFile]

data/spec/api/users_api_spec.rb

@@ -82,4 +82,14 @@ describe 'UsersApi' do
     end
   end
 
+  # unit tests for who_am_i
+  # Me Endpoint
+  # @param [Hash] opts the optional parameters
+  # @return [UserResponse]
+  describe 'who_am_i test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
 end