DhanHQ 2.5.0 → 2.6.1

data/lib/DhanHQ/models/order.rb

@@ -46,6 +46,8 @@ module DhanHQ
     #   puts "Pending orders: #{pending_orders.count}"
     #
     class Order < BaseModel
+      include Concerns::ApiResponseHandler
+
       # Attributes eligible for modification requests.
       MODIFIABLE_FIELDS = %i[
         dhan_client_id
@@ -57,10 +59,10 @@ module DhanHQ
         disclosed_quantity
         validity
         leg_name
+        bo_profit_value
+        bo_stop_loss_value
       ].freeze
 
-      attr_reader :order_id, :order_status
-
       # Define attributes that are part of an order
       attributes :dhan_client_id, :order_id, :correlation_id, :order_status,
                  :transaction_type, :exchange_segment, :product_type, :order_type,
@@ -168,9 +170,10 @@ module DhanHQ
         #
         def find(order_id)
           response = resource.find(order_id)
-          return nil unless response.is_a?(Hash) || (response.is_a?(Array) && response.any?)
+          is_array = response.is_a?(Array)
+          return nil unless response.is_a?(Hash) || (is_array && response.any?)
 
-          order_data = response.is_a?(Array) ? response.first : response
+          order_data = is_array ? response.first : response
           new(order_data, skip_validation: true)
         end
 
@@ -286,15 +289,19 @@ module DhanHQ
         # @raise [DhanHQ::ValidationError] If validation fails for any parameter
         def place(params)
           normalized_params = snake_case(params)
+          config = DhanHQ.configuration
           # Auto-inject dhan_client_id from configuration if not provided
-          normalized_params[:dhan_client_id] ||= DhanHQ.configuration.client_id if DhanHQ.configuration.client_id
+          normalized_params[:dhan_client_id] ||= config.client_id if config&.client_id
           validate_params!(normalized_params, DhanHQ::Contracts::PlaceOrderContract)
 
           response = resource.create(camelize_keys(normalized_params))
-          return nil unless response.is_a?(Hash) && response["orderId"]
+          return nil unless response.is_a?(Hash)
+
+          order_id = response["orderId"]
+          return nil unless order_id
 
           # Fetch the complete order details
-          find(response["orderId"])
+          find(order_id)
         end
 
         ##
@@ -366,25 +373,12 @@ module DhanHQ
       def modify(new_params)
         raise "Order ID is required to modify an order" unless id
 
-        # Log warning for invalid states but still attempt API call (let API handle validation)
-        # This maintains backward compatibility - API will return appropriate error
-        if order_status && %w[TRADED CANCELLED EXPIRED CLOSED].include?(order_status)
-          DhanHQ.logger&.warn("[DhanHQ::Models::Order] Attempting to modify order #{id} in #{order_status} state - API will reject")
-        end
-
-        base_payload = attributes.merge(new_params)
-        normalized_payload = snake_case(base_payload).merge(order_id: id)
-        filtered_payload = normalized_payload.each_with_object({}) do |(key, value), memo|
-          symbolized_key = key.respond_to?(:to_sym) ? key.to_sym : key
-          memo[symbolized_key] = value if MODIFIABLE_FIELDS.include?(symbolized_key)
-        end
-        filtered_payload[:order_id] ||= id
-        filtered_payload[:dhan_client_id] ||= attributes[:dhan_client_id] || DhanHQ.configuration&.client_id
+        warn_invalid_state if order_status_invalid_for_modification?
 
-        cleaned_payload = filtered_payload.compact
-        formatted_payload = camelize_keys(cleaned_payload)
-        validate_params!(formatted_payload, DhanHQ::Contracts::ModifyOrderContract)
+        filtered_payload = prepare_modify_payload(new_params)
+        validate_params!(filtered_payload, DhanHQ::Contracts::ModifyOrderContract)
 
+        formatted_payload = camelize_keys(filtered_payload)
         response = self.class.resource.update(id, formatted_payload)
         response = response.with_indifferent_access if response.respond_to?(:with_indifferent_access)
 
@@ -415,8 +409,15 @@ module DhanHQ
       def cancel
         raise "Order ID is required to cancel an order" unless id
 
+        DhanHQ.logger&.info("[DhanHQ::Models::Order] Cancelling order #{id}")
         response = self.class.resource.cancel(id)
-        response["orderStatus"] == "CANCELLED"
+        if response["orderStatus"] == DhanHQ::Constants::OrderStatus::CANCELLED
+          DhanHQ.logger&.info("[DhanHQ::Models::Order] Order #{id} cancelled successfully")
+          true
+        else
+          DhanHQ.logger&.error("[DhanHQ::Models::Order] Cancel failed for order #{id}: #{response.inspect}")
+          false
+        end
       end
 
       ##
@@ -453,6 +454,44 @@ module DhanHQ
         order_id.nil? || order_id.to_s.empty?
       end
 
+      def destroy
+        return false if new_record?
+
+        DhanHQ.logger&.info("[DhanHQ::Models::Order] Destroying order #{id}")
+        response = self.class.resource.delete(id)
+        if success_response?(response) && response["orderStatus"] == DhanHQ::Constants::OrderStatus::CANCELLED
+          @attributes[:order_status] = DhanHQ::Constants::OrderStatus::CANCELLED
+          DhanHQ.logger&.info("[DhanHQ::Models::Order] Order #{id} destroyed successfully")
+          true
+        else
+          DhanHQ.logger&.error("[DhanHQ::Models::Order] Destroy failed for order #{id}")
+          false
+        end
+      end
+      alias delete destroy
+
+      def slice_order(params)
+        raise "Order ID is required to slice an order" unless id
+
+        normalized = snake_case(params)
+        normalized[:dhan_client_id] ||= DhanHQ.configuration&.client_id
+        base_payload = normalized.merge(order_id: id)
+        formatted_payload = camelize_keys(base_payload)
+
+        validate_params!(formatted_payload, DhanHQ::Contracts::SliceOrderContract)
+
+        self.class.resource.slicing(formatted_payload)
+      end
+
+      def validation_contract
+        order_id_val = @attributes[:order_id] || @attributes[:orderId]
+        if order_id_val.nil? || order_id_val.to_s.empty?
+          DhanHQ::Contracts::PlaceOrderContract.new
+        else
+          DhanHQ::Contracts::ModifyOrderContract.new
+        end
+      end
+
       ##
       # Returns the order ID used for resource calls.
       #
@@ -495,40 +534,53 @@ module DhanHQ
         return false unless valid?
 
         if new_record?
-          # PLACE ORDER
-          DhanHQ.logger&.info("[DhanHQ::Models::Order] Placing order: #{attributes.slice(:transaction_type,
-                                                                                         :exchange_segment, :security_id, :quantity, :price).inspect}")
-          response = self.class.resource.create(to_request_params)
-          if success_response?(response) && response["orderId"]
-            @attributes.merge!(normalize_keys(response))
-            assign_attributes
-            DhanHQ.logger&.info("[DhanHQ::Models::Order] Order placed successfully: #{response["orderId"]}")
-            true
-          else
-            error_msg = response.is_a?(Hash) ? response[:errorMessage] || response[:message] || "Unknown error" : "Invalid response format"
-            DhanHQ.logger&.error("[DhanHQ::Models::Order] Order placement failed: #{error_msg}")
-            @errors = response if response.is_a?(Hash)
-            false
-          end
+          save_new_order
         else
-          # MODIFY ORDER
-          DhanHQ.logger&.info("[DhanHQ::Models::Order] Modifying order #{id}: #{attributes.slice(:price, :quantity,
-                                                                                                 :order_type).inspect}")
-          response = self.class.resource.update(id, to_request_params)
-          if success_response?(response) && response["orderStatus"]
-            @attributes.merge!(normalize_keys(response))
-            assign_attributes
-            DhanHQ.logger&.info("[DhanHQ::Models::Order] Order modified successfully: #{id}")
-            true
-          else
-            error_msg = response.is_a?(Hash) ? response[:errorMessage] || response[:message] || "Unknown error" : "Invalid response format"
-            DhanHQ.logger&.error("[DhanHQ::Models::Order] Order modification failed for #{id}: #{error_msg}")
-            @errors = response if response.is_a?(Hash)
-            false
-          end
+          modify_existing_order
         end
       end
 
+      private
+
+      def save_new_order
+        DhanHQ.logger&.info("[DhanHQ::Models::Order] Placing order: #{attributes.slice(:transaction_type, :exchange_segment, :security_id, :quantity, :price).inspect}")
+        response = self.class.resource.create(to_request_params)
+        handle_api_response(response, success_key: "orderId", context: "[DhanHQ::Models::Order] Order placement")
+      end
+
+      def modify_existing_order
+        DhanHQ.logger&.info("[DhanHQ::Models::Order] Modifying order #{id}: #{attributes.slice(:price, :quantity, :order_type).inspect}")
+        response = self.class.resource.update(id, to_request_params)
+        handle_api_response(response, success_key: "orderStatus", context: "[DhanHQ::Models::Order] Order modification")
+      end
+
+      def order_status_invalid_for_modification?
+        order_status && %w[TRADED CANCELLED EXPIRED CLOSED].include?(order_status)
+      end
+
+      def warn_invalid_state
+        DhanHQ.logger&.warn("[DhanHQ::Models::Order] Attempting to modify order #{id} in #{order_status} state - API will reject")
+      end
+
+      def prepare_modify_payload(new_params)
+        base_payload = attributes.merge(new_params)
+        normalized_payload = snake_case(base_payload).merge(order_id: id)
+
+        filtered_payload = normalized_payload.each_with_object({}) do |(key, value), memo|
+          symbolized_key = key.respond_to?(:to_sym) ? key.to_sym : key
+          memo[symbolized_key] = value if MODIFIABLE_FIELDS.include?(symbolized_key)
+        end
+
+        filtered_payload[:order_id] ||= id
+        filtered_payload[:dhan_client_id] ||= attributes[:dhan_client_id] || DhanHQ.configuration&.client_id
+
+        # Don't send trigger_price when it's 0 for non–stop-loss orders (API default; avoids validation noise).
+        order_type = filtered_payload[:order_type].to_s
+        filtered_payload.delete(:trigger_price) if !%w[STOP_LOSS STOP_LOSS_MARKET].include?(order_type) && filtered_payload[:trigger_price].to_f.zero?
+
+        filtered_payload.compact
+      end
+
       ##
       # Cancels (destroys) the order.
       #
@@ -545,77 +597,6 @@ module DhanHQ
       #   end
       #
       # @note This method does nothing for new (unsaved) orders.
-      def destroy
-        return false if new_record?
-
-        response = self.class.resource.delete(id)
-        if success_response?(response) && response["orderStatus"] == "CANCELLED"
-          @attributes[:order_status] = "CANCELLED"
-          true
-        else
-          false
-        end
-      end
-      alias delete destroy
-
-      ##
-      # Slices an order into multiple legs to place orders over freeze limit quantity.
-      #
-      # This API helps you slice your order request into multiple orders to allow you
-      # to place over freeze limit quantity for F&O instruments. Returns an array of
-      # orders created from the slice operation.
-      #
-      # @param params [Hash{Symbol => String, Integer, Float, Boolean}] Order parameters for slicing.
-      #   Same parameters as {place}, but quantity can exceed freeze limits as it will be
-      #   automatically split into multiple orders.
-      #
-      # @return [Array<Hash>] Array of order objects created from the slice operation.
-      #   Each hash contains:
-      #   - **:order_id** [String] Order-specific identification generated by Dhan
-      #   - **:order_status** [String] Order status. Valid values: "TRANSIT", "PENDING",
-      #     "REJECTED", "CANCELLED", "TRADED", "EXPIRED", "CONFIRM"
-      #
-      # @example Slice a large order
-      #   order = DhanHQ::Models::Order.find("112111182045")
-      #   sliced_orders = order.slice_order(
-      #     dhan_client_id: "1000000003",
-      #     transaction_type: "BUY",
-      #     exchange_segment: "NSE_FNO",
-      #     product_type: "INTRADAY",
-      #     order_type: "MARKET",
-      #     validity: "DAY",
-      #     security_id: "49081",
-      #     quantity: 50000  # Will be split into multiple orders
-      #   )
-      #   puts "Created #{sliced_orders.count} orders"
-      #
-      # @raise [RuntimeError] If order ID is missing
-      # @raise [DhanHQ::ValidationError] If validation fails for any parameter
-      def slice_order(params)
-        raise "Order ID is required to slice an order" unless id
-
-        base_payload = params.merge(order_id: id)
-        formatted_payload = camelize_keys(base_payload)
-
-        validate_params!(formatted_payload, DhanHQ::Contracts::SliceOrderContract)
-
-        self.class.resource.slicing(formatted_payload)
-      end
-
-      ##
-      # Returns the appropriate validation contract based on order state.
-      #
-      # For new records, returns PlaceOrderContract. For existing records, returns
-      # ModifyOrderContract. This allows the same validation logic to be used for
-      # both creating and modifying orders.
-      #
-      # @return [DhanHQ::Contracts::PlaceOrderContract, DhanHQ::Contracts::ModifyOrderContract]
-      #   The appropriate validation contract based on whether this is a new or existing order
-      #
-      # @api private
-      def validation_contract
-        new_record? ? DhanHQ::Contracts::PlaceOrderContract.new : DhanHQ::Contracts::ModifyOrderContract.new
-      end
     end
   end
 end

data/lib/DhanHQ/models/order_update.rb

@@ -31,12 +31,6 @@ module DhanHQ
         new(data, skip_validation: true)
       end
 
-      ##
-      # OrderUpdate objects are read-only, so no validation contract needed
-      def validation_contract
-        nil
-      end
-
       ##
       # Helper methods for transaction type
       def buy?
@@ -94,33 +88,33 @@ module DhanHQ
       ##
       # Helper methods for order status
       def transit?
-        status == "TRANSIT"
+        status == DhanHQ::Constants::OrderStatus::TRANSIT
       end
 
       def pending?
-        status == "PENDING"
+        status == DhanHQ::Constants::OrderStatus::PENDING
       end
 
       def rejected?
-        status == "REJECTED"
+        status == DhanHQ::Constants::OrderStatus::REJECTED
       end
 
       def cancelled?
-        status == "CANCELLED"
+        status == DhanHQ::Constants::OrderStatus::CANCELLED
       end
 
       def traded?
-        status == "TRADED"
+        status == DhanHQ::Constants::OrderStatus::TRADED
       end
 
       def expired?
-        status == "EXPIRED"
+        status == DhanHQ::Constants::OrderStatus::EXPIRED
       end
 
       ##
       # Helper methods for instrument type
       def equity?
-        instrument == "EQUITY"
+        instrument == DhanHQ::Constants::InstrumentType::EQUITY
       end
 
       def derivative?

data/lib/DhanHQ/models/pnl_exit.rb

@@ -75,6 +75,7 @@ module DhanHQ
             productType: product_type,
             enableKillSwitch: enable_kill_switch
           }
+          params[:dhanClientId] = DhanHQ.configuration.client_id if DhanHQ.configuration&.client_id.to_s != ""
           resource.configure(params)
         end
 
@@ -116,15 +117,6 @@ module DhanHQ
           new(response, skip_validation: true)
         end
       end
-
-      ##
-      # No validation contract needed — server-side validation handles it.
-      #
-      # @return [nil]
-      # @api private
-      def validation_contract
-        nil
-      end
     end
   end
 end

data/lib/DhanHQ/models/position.rb

@@ -139,7 +139,7 @@ module DhanHQ
         #   puts "Total open position value: ₹#{total_value}"
         #
         def active
-          all.reject { |position| position.position_type == "CLOSED" }
+          all.reject { |position| position.position_type == DhanHQ::Constants::OrderStatus::CLOSED }
         end
 
         ##

data/lib/DhanHQ/models/postback.rb

@@ -83,7 +83,7 @@ module DhanHQ
       #
       # @return [Boolean]
       def traded?
-        order_status == "TRADED"
+        order_status == DhanHQ::Constants::OrderStatus::TRADED
       end
 
       ##
@@ -91,7 +91,7 @@ module DhanHQ
       #
       # @return [Boolean]
       def rejected?
-        order_status == "REJECTED"
+        order_status == DhanHQ::Constants::OrderStatus::REJECTED
       end
 
       ##
@@ -99,7 +99,7 @@ module DhanHQ
       #
       # @return [Boolean]
       def pending?
-        order_status == "PENDING"
+        order_status == DhanHQ::Constants::OrderStatus::PENDING
       end
 
       ##
@@ -107,16 +107,7 @@ module DhanHQ
       #
       # @return [Boolean]
       def cancelled?
-        order_status == "CANCELLED"
-      end
-
-      ##
-      # No validation contract — postback payloads are parsed as-is.
-      #
-      # @return [nil]
-      # @api private
-      def validation_contract
-        nil
+        order_status == DhanHQ::Constants::OrderStatus::CANCELLED
       end
     end
   end

data/lib/DhanHQ/models/profile.rb

@@ -125,16 +125,6 @@ module DhanHQ
 
       ##
       # Profile responses are informational and not validated locally.
-      #
-      # Since profile data is read-only account metadata, no validation contract
-      # is needed. The API response is trusted as-is.
-      #
-      # @return [nil] Always returns nil as profiles are read-only and informational
-      #
-      # @api private
-      def validation_contract
-        nil
-      end
     end
   end
 end

data/lib/DhanHQ/models/super_order.rb

@@ -48,6 +48,8 @@ module DhanHQ
     #   order.cancel("STOP_LOSS_LEG")
     #
     class SuperOrder < BaseModel
+      include Concerns::ApiResponseHandler
+
       attributes :dhan_client_id, :order_id, :correlation_id, :order_status,
                  :transaction_type, :exchange_segment, :product_type, :order_type,
                  :validity, :trading_symbol, :security_id, :quantity,
@@ -284,8 +286,12 @@ module DhanHQ
       def modify(new_params)
         raise "Order ID is required to modify a super order" unless id
 
+        DhanHQ.logger&.info("[DhanHQ::Models::SuperOrder] Modifying super order #{id}")
         response = self.class.resource.update(id, new_params)
-        response["orderId"] == id
+        return false unless response.is_a?(Hash) && response["orderId"] == id
+
+        DhanHQ.logger&.info("[DhanHQ::Models::SuperOrder] Super order #{id} modified successfully")
+        true
       end
 
       ##
@@ -318,11 +324,15 @@ module DhanHQ
       #   order.cancel("TARGET_LEG")
       #
       # @raise [RuntimeError] If order ID is missing
-      def cancel(leg_name = "ENTRY_LEG")
+      def cancel(leg_name = DhanHQ::Constants::LegName::ENTRY_LEG)
         raise "Order ID is required to cancel a super order" unless id
 
+        DhanHQ.logger&.info("[DhanHQ::Models::SuperOrder] Cancelling super order #{id} leg #{leg_name}")
         response = self.class.resource.cancel(id, leg_name)
-        response["orderStatus"] == "CANCELLED"
+        return false unless response.is_a?(Hash) && response["orderStatus"] == DhanHQ::Constants::OrderStatus::CANCELLED
+
+        DhanHQ.logger&.info("[DhanHQ::Models::SuperOrder] Super order #{id} leg #{leg_name} cancelled successfully")
+        true
       end
     end
   end

data/lib/DhanHQ/models/trade.rb

@@ -49,8 +49,8 @@ module DhanHQ
         # Provides a shared instance of the Trades resource for current day tradebook APIs.
         #
         # @return [DhanHQ::Resources::Trades] The Trades resource client instance
-        def tradebook_resource
-          @tradebook_resource ||= DhanHQ::Resources::Trades.new
+        def resource
+          @resource ||= DhanHQ::Resources::Trades.new
         end
 
         ##
@@ -107,10 +107,8 @@ module DhanHQ
         #   puts "P&L: ₹#{pnl}"
         #
         def today
-          response = tradebook_resource.all
-          return [] unless response.is_a?(Array)
-
-          response.map { |trade_data| new(trade_data, skip_validation: true) }
+          response = resource.all
+          parse_collection_response(response)
         end
 
         ##
@@ -145,7 +143,7 @@ module DhanHQ
             raise DhanHQ::ValidationError, "Invalid order_id: #{validation_result.errors.to_h}"
           end
 
-          response = tradebook_resource.find(order_id)
+          response = resource.find(order_id)
           return nil unless response.is_a?(Hash) || (response.is_a?(Array) && response.any?)
 
           data = response.is_a?(Array) ? response.first : response
@@ -248,16 +246,6 @@ module DhanHQ
         alias all history
       end
 
-      ##
-      # Trade objects are read-only, so no validation contract needed.
-      #
-      # @return [nil] Always returns nil as trades are read-only
-      #
-      # @api private
-      def validation_contract
-        nil
-      end
-
       ##
       # Checks if the trade is a BUY transaction.
       #
@@ -270,7 +258,7 @@ module DhanHQ
       #   end
       #
       def buy?
-        transaction_type == "BUY"
+        transaction_type == DhanHQ::Constants::TransactionType::BUY
       end
 
       ##
@@ -285,7 +273,7 @@ module DhanHQ
       #   end
       #
       def sell?
-        transaction_type == "SELL"
+        transaction_type == DhanHQ::Constants::TransactionType::SELL
       end
 
       ##
@@ -299,7 +287,7 @@ module DhanHQ
       #   puts "Equity trades: #{equity_trades.count}"
       #
       def equity?
-        instrument == "EQUITY"
+        instrument == DhanHQ::Constants::InstrumentType::EQUITY
       end
 
       ##
@@ -327,7 +315,7 @@ module DhanHQ
       #   puts "Option trades: #{option_trades.count}"
       #
       def option?
-        %w[CALL PUT].include?(drv_option_type)
+        [DhanHQ::Constants::OptionType::CALL, DhanHQ::Constants::OptionType::PUT].include?(drv_option_type)
       end
 
       ##
@@ -341,7 +329,7 @@ module DhanHQ
       #   puts "Call option trades: #{call_trades.count}"
       #
       def call_option?
-        drv_option_type == "CALL"
+        drv_option_type == DhanHQ::Constants::OptionType::CALL
       end
 
       ##
@@ -355,7 +343,7 @@ module DhanHQ
       #   puts "Put option trades: #{put_trades.count}"
       #
       def put_option?
-        drv_option_type == "PUT"
+        drv_option_type == DhanHQ::Constants::OptionType::PUT
       end
 
       ##

data/lib/DhanHQ/resources/ip_setup.rb

@@ -2,7 +2,8 @@
 
 module DhanHQ
   module Resources
-    # Resource for IP whitelist per API docs: GET /ip/getIP, POST /ip/setIP, PUT /ip/modifyIP.
+    # Resource for IP whitelist per API docs: GET /v2/ip/getIP, POST /v2/ip/setIP, PUT /v2/ip/modifyIP.
+    # Set/Modify require dhanClientId, ip, ipFlag (PRIMARY | SECONDARY). See dhanhq.co/docs/v2/authentication/#setup-static-ip
     class IPSetup < BaseAPI
       API_TYPE  = :order_api
       HTTP_PATH = "/ip"
@@ -11,12 +12,22 @@ module DhanHQ
         get("/getIP")
       end
 
-      def set(ip:)
-        post("/setIP", params: { ip: ip })
+      # @param ip [String] Static IP (IPv4 or IPv6)
+      # @param ip_flag [String] "PRIMARY" or "SECONDARY"
+      # @param dhan_client_id [String, nil] Defaults to DhanHQ.configuration.client_id when nil
+      def set(ip:, ip_flag: "PRIMARY", dhan_client_id: nil)
+        params = { ip: ip, ip_flag: ip_flag }
+        params[:dhan_client_id] = dhan_client_id || DhanHQ.configuration&.client_id
+        post("/setIP", params: params)
       end
 
-      def update(ip:)
-        put("/modifyIP", params: { ip: ip })
+      # @param ip [String] Static IP (IPv4 or IPv6)
+      # @param ip_flag [String] "PRIMARY" or "SECONDARY"
+      # @param dhan_client_id [String, nil] Defaults to DhanHQ.configuration.client_id when nil
+      def update(ip:, ip_flag: "PRIMARY", dhan_client_id: nil)
+        params = { ip: ip, ip_flag: ip_flag }
+        params[:dhan_client_id] = dhan_client_id || DhanHQ.configuration&.client_id
+        put("/modifyIP", params: params)
       end
     end
   end

data/lib/DhanHQ/resources/kill_switch.rb

@@ -1,20 +1,22 @@
 # frozen_string_literal: true
 
+require "cgi"
+
 module DhanHQ
   module Resources
     # Resource client to control the trading kill switch feature.
+    # API expects killSwitchStatus as query parameter (no body). See dhanhq.co/docs/v2/traders-control/
     class KillSwitch < BaseAPI
-      # Kill switch operations execute on the trading API tier.
-      API_TYPE = :order_api
-      # Base path for kill switch operations.
+      API_TYPE  = :order_api
       HTTP_PATH = "/v2/killswitch"
 
-      # Enables or disables the kill switch.
+      # Enables or disables the kill switch via query parameter (doc: no body).
       #
-      # @param params [Hash]
+      # @param status [String] "ACTIVATE" or "DEACTIVATE"
       # @return [Hash]
-      def update(params)
-        post("", params: params)
+      def update(status)
+        query = "?killSwitchStatus=#{CGI.escape(status.to_s)}"
+        handle_response(client.post(build_path(query), {}))
       end
 
       ##