def history(options = {})

      merged_options = {
        :date => 'recent',
        :timezone => 'UTC',
        :format => 'JSON',
        :'max-results' => 100,
        :'start-index' => 0,
        :'end-date' => nil
      }.merge options

      response = self.class.get(@api.history_config[:url],
        :query => {
          :room_id    => room_id,
          :date       => merged_options[:date],
          :timezone   => merged_options[:timezone],
          :format     => merged_options[:format],
          :'max-results' => merged_options[:'max-results'],
          :'start-index' => merged_options[:'start-index'],
          :'end-date' => merged_options[:'end-date'],
          :auth_token => @token
        }.reject!{|k,v| v.nil?},
        :headers => @api.headers
      )

      ErrorHandler.response_code_to_exception_for :room, room_id, response
      response.body
    end
def history(options = {})

      merged_options = {
        :date => 'recent',
        :timezone => 'UTC',
        :format => 'JSON',
        :'max-results' => 100,
        :'start-index' => 0,
        :'end-date' => nil
      }.merge options

      response = self.class.get(@api.history_config[:url],
        :query => {
          :room_id    => room_id,
          :date       => merged_options[:date],
          :timezone   => merged_options[:timezone],
          :format     => merged_options[:format],
          :'max-results' => merged_options[:'max-results'],
          :'start-index' => merged_options[:'start-index'],
          :'end-date' => merged_options[:'end-date'],
          :auth_token => @token
        }.reject!{|k,v| v.nil?},
        :headers => @api.headers
      )

      ErrorHandler.response_code_to_exception_for :room, room_id, response
      response.body
    end
Pull this room's history

 Usage

   # Default


 Options

 +date+::     Whether to return a specific day (YYYY-MM-DD format) or recent
                (default "recent")
 +timezone+:: Your timezone.  Supported timezones are at: https://www.hipchat.com/docs/api/timezones
                (default "UTC")
 +format+::   Format to retrieve the history in.  Valid options are JSON and XML
                (default "JSON")