feat(api): make filter optional for Spend Velocity Auth Rules

stainless-app[bot] · stainless-app[bot] · commit 3e09d4a5488c · 2026-01-15T19:46:53.000Z
fix(api): rename WIRE_DRAWDOWN_REQUEST to WIRE_INBOUND_DRAWDOWN_REQUEST
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 176
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-4ecc06edca2cfad4eaf11573611e89823fda5f56370bac5cd02a498a6b277d09.yml
-openapi_spec_hash: 8f4a30bec4348cbde85b1e65bef9189a
-config_hash: 751a4cc75aa0276b40cc2c7879b24dea
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-c06c4d54858775fef1de57e33d471e997cb28fe0c925fd7b08ba45fdd335e938.yml
+openapi_spec_hash: 23745357b2171bcdfb5d30bfef1df48d
+config_hash: 9dddee5f7af579864599849cb28a0770
diff --git a/README.md b/README.md
@@ -2,15 +2,6 @@
 
 The Lithic Ruby library provides convenient access to the Lithic REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/lithic-com/lithic-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
-## MCP Server
-
-Use the Lithic MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
-
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=lithic-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImxpdGhpYy1tY3AiXX0)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22lithic-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22lithic-mcp%22%5D%7D)
-
-> Note: You may need to set environment variables in your MCP client.
-
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/lithic).
diff --git a/lib/lithic/models/auth_rules/velocity_limit_params.rb b/lib/lithic/models/auth_rules/velocity_limit_params.rb
@@ -4,11 +4,6 @@ module Lithic
   module Models
     module AuthRules
       class VelocityLimitParams < Lithic::Internal::Type::BaseModel
-        # @!attribute filters
-        #
-        #   @return [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
-        required :filters, -> { Lithic::AuthRules::VelocityLimitParams::Filters }
-
         # @!attribute period
         #   Velocity over the current day since 00:00 / 12 AM in Eastern Time
         #
@@ -21,6 +16,11 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParams::Scope]
         required :scope, enum: -> { Lithic::AuthRules::VelocityLimitParams::Scope }
 
+        # @!attribute filters
+        #
+        #   @return [Lithic::Models::AuthRules::VelocityLimitParams::Filters, nil]
+        optional :filters, -> { Lithic::AuthRules::VelocityLimitParams::Filters }
+
         # @!attribute limit_amount
         #   The maximum amount of spend velocity allowed in the period in minor units (the
         #   smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
@@ -39,20 +39,33 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         optional :limit_count, Integer, nil?: true
 
-        # @!method initialize(filters:, period:, scope:, limit_amount: nil, limit_count: nil)
+        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_count: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::VelocityLimitParams} for more details.
         #
-        #   @param filters [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
-        #
         #   @param period [Lithic::Models::AuthRules::VelocityLimitPeriod::TrailingWindowObject, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowDay, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowWeek, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowMonth, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowYear] Velocity over the current day since 00:00 / 12 AM in Eastern Time
         #
         #   @param scope [Symbol, Lithic::Models::AuthRules::VelocityLimitParams::Scope] The scope the velocity is calculated for
         #
+        #   @param filters [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
+        #
         #   @param limit_amount [Integer, nil] The maximum amount of spend velocity allowed in the period in minor units (the s
         #
         #   @param limit_count [Integer, nil] The number of spend velocity impacting transactions may not exceed this limit in
 
+        # The scope the velocity is calculated for
+        #
+        # @see Lithic::Models::AuthRules::VelocityLimitParams#scope
+        module Scope
+          extend Lithic::Internal::Type::Enum
+
+          CARD = :CARD
+          ACCOUNT = :ACCOUNT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see Lithic::Models::AuthRules::VelocityLimitParams#filters
         class Filters < Lithic::Internal::Type::BaseModel
           # @!attribute exclude_countries
@@ -133,19 +146,6 @@ module IncludePanEntryMode
             #   @return [Array<Symbol>]
           end
         end
-
-        # The scope the velocity is calculated for
-        #
-        # @see Lithic::Models::AuthRules::VelocityLimitParams#scope
-        module Scope
-          extend Lithic::Internal::Type::Enum
-
-          CARD = :CARD
-          ACCOUNT = :ACCOUNT
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
       end
     end
   end
diff --git a/lib/lithic/models/payment.rb b/lib/lithic/models/payment.rb
@@ -650,7 +650,7 @@ module Type
         WIRE_INBOUND_ADMIN = :WIRE_INBOUND_ADMIN
         WIRE_OUTBOUND_PAYMENT = :WIRE_OUTBOUND_PAYMENT
         WIRE_OUTBOUND_ADMIN = :WIRE_OUTBOUND_ADMIN
-        WIRE_DRAWDOWN_REQUEST = :WIRE_DRAWDOWN_REQUEST
+        WIRE_INBOUND_DRAWDOWN_REQUEST = :WIRE_INBOUND_DRAWDOWN_REQUEST
 
         # @!method self.values
         #   @return [Array<Symbol>]
diff --git a/rbi/lithic/models/auth_rules/velocity_limit_params.rbi b/rbi/lithic/models/auth_rules/velocity_limit_params.rbi
@@ -12,16 +12,6 @@ module Lithic
             )
           end
 
-        sig { returns(Lithic::AuthRules::VelocityLimitParams::Filters) }
-        attr_reader :filters
-
-        sig do
-          params(
-            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash
-          ).void
-        end
-        attr_writer :filters
-
         # Velocity over the current day since 00:00 / 12 AM in Eastern Time
         sig do
           returns(
@@ -40,6 +30,18 @@ module Lithic
         sig { returns(Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol) }
         attr_accessor :scope
 
+        sig do
+          returns(T.nilable(Lithic::AuthRules::VelocityLimitParams::Filters))
+        end
+        attr_reader :filters
+
+        sig do
+          params(
+            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash
+          ).void
+        end
+        attr_writer :filters
+
         # The maximum amount of spend velocity allowed in the period in minor units (the
         # smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
         # limit will be declined.
@@ -56,7 +58,6 @@ module Lithic
 
         sig do
           params(
-            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash,
             period:
               T.any(
                 Lithic::AuthRules::VelocityLimitPeriod::TrailingWindowObject::OrHash,
@@ -66,16 +67,17 @@ module Lithic
                 Lithic::AuthRules::VelocityLimitPeriod::FixedWindowYear::OrHash
               ),
             scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
+            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash,
             limit_amount: T.nilable(Integer),
             limit_count: T.nilable(Integer)
           ).returns(T.attached_class)
         end
         def self.new(
-          filters:,
           # Velocity over the current day since 00:00 / 12 AM in Eastern Time
           period:,
           # The scope the velocity is calculated for
           scope:,
+          filters: nil,
           # The maximum amount of spend velocity allowed in the period in minor units (the
           # smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
           # limit will be declined.
@@ -92,7 +94,6 @@ module Lithic
         sig do
           override.returns(
             {
-              filters: Lithic::AuthRules::VelocityLimitParams::Filters,
               period:
                 T.any(
                   Lithic::AuthRules::VelocityLimitPeriod::TrailingWindowObject,
@@ -102,6 +103,7 @@ module Lithic
                   Lithic::AuthRules::VelocityLimitPeriod::FixedWindowYear
                 ),
               scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
+              filters: Lithic::AuthRules::VelocityLimitParams::Filters,
               limit_amount: T.nilable(Integer),
               limit_count: T.nilable(Integer)
             }
@@ -110,6 +112,38 @@ module Lithic
         def to_hash
         end
 
+        # The scope the velocity is calculated for
+        module Scope
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Lithic::AuthRules::VelocityLimitParams::Scope)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          CARD =
+            T.let(
+              :CARD,
+              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+            )
+          ACCOUNT =
+            T.let(
+              :ACCOUNT,
+              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         class Filters < Lithic::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
@@ -307,38 +341,6 @@ module Lithic
             end
           end
         end
-
-        # The scope the velocity is calculated for
-        module Scope
-          extend Lithic::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(Symbol, Lithic::AuthRules::VelocityLimitParams::Scope)
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          CARD =
-            T.let(
-              :CARD,
-              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-            )
-          ACCOUNT =
-            T.let(
-              :ACCOUNT,
-              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[
-                Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-              ]
-            )
-          end
-          def self.values
-          end
-        end
       end
     end
   end
diff --git a/rbi/lithic/models/payment.rbi b/rbi/lithic/models/payment.rbi
@@ -1061,8 +1061,11 @@ module Lithic
           T.let(:WIRE_OUTBOUND_PAYMENT, Lithic::Payment::Type::TaggedSymbol)
         WIRE_OUTBOUND_ADMIN =
           T.let(:WIRE_OUTBOUND_ADMIN, Lithic::Payment::Type::TaggedSymbol)
-        WIRE_DRAWDOWN_REQUEST =
-          T.let(:WIRE_DRAWDOWN_REQUEST, Lithic::Payment::Type::TaggedSymbol)
+        WIRE_INBOUND_DRAWDOWN_REQUEST =
+          T.let(
+            :WIRE_INBOUND_DRAWDOWN_REQUEST,
+            Lithic::Payment::Type::TaggedSymbol
+          )
 
         sig { override.returns(T::Array[Lithic::Payment::Type::TaggedSymbol]) }
         def self.values
diff --git a/sig/lithic/models/auth_rules/velocity_limit_params.rbs b/sig/lithic/models/auth_rules/velocity_limit_params.rbs
@@ -3,40 +3,55 @@ module Lithic
     module AuthRules
       type velocity_limit_params =
         {
-          filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           period: Lithic::Models::AuthRules::velocity_limit_period,
           scope: Lithic::Models::AuthRules::VelocityLimitParams::scope,
+          filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           limit_amount: Integer?,
           limit_count: Integer?
         }
 
       class VelocityLimitParams < Lithic::Internal::Type::BaseModel
-        attr_accessor filters: Lithic::AuthRules::VelocityLimitParams::Filters
-
         attr_accessor period: Lithic::Models::AuthRules::velocity_limit_period
 
         attr_accessor scope: Lithic::Models::AuthRules::VelocityLimitParams::scope
 
+        attr_reader filters: Lithic::AuthRules::VelocityLimitParams::Filters?
+
+        def filters=: (
+          Lithic::AuthRules::VelocityLimitParams::Filters
+        ) -> Lithic::AuthRules::VelocityLimitParams::Filters
+
         attr_accessor limit_amount: Integer?
 
         attr_accessor limit_count: Integer?
 
         def initialize: (
-          filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           period: Lithic::Models::AuthRules::velocity_limit_period,
           scope: Lithic::Models::AuthRules::VelocityLimitParams::scope,
+          ?filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           ?limit_amount: Integer?,
           ?limit_count: Integer?
         ) -> void
 
         def to_hash: -> {
-          filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           period: Lithic::Models::AuthRules::velocity_limit_period,
           scope: Lithic::Models::AuthRules::VelocityLimitParams::scope,
+          filters: Lithic::AuthRules::VelocityLimitParams::Filters,
           limit_amount: Integer?,
           limit_count: Integer?
         }
 
+        type scope = :CARD | :ACCOUNT
+
+        module Scope
+          extend Lithic::Internal::Type::Enum
+
+          CARD: :CARD
+          ACCOUNT: :ACCOUNT
+
+          def self?.values: -> ::Array[Lithic::Models::AuthRules::VelocityLimitParams::scope]
+        end
+
         type filters =
           {
             exclude_countries: ::Array[String]?,
@@ -112,17 +127,6 @@ module Lithic
             def self?.values: -> ::Array[Lithic::Models::AuthRules::VelocityLimitParams::Filters::include_pan_entry_mode]
           end
         end
-
-        type scope = :CARD | :ACCOUNT
-
-        module Scope
-          extend Lithic::Internal::Type::Enum
-
-          CARD: :CARD
-          ACCOUNT: :ACCOUNT
-
-          def self?.values: -> ::Array[Lithic::Models::AuthRules::VelocityLimitParams::scope]
-        end
       end
     end
   end
diff --git a/sig/lithic/models/payment.rbs b/sig/lithic/models/payment.rbs
@@ -524,7 +524,7 @@ module Lithic
         | :WIRE_INBOUND_ADMIN
         | :WIRE_OUTBOUND_PAYMENT
         | :WIRE_OUTBOUND_ADMIN
-        | :WIRE_DRAWDOWN_REQUEST
+        | :WIRE_INBOUND_DRAWDOWN_REQUEST
 
       module Type
         extend Lithic::Internal::Type::Enum
@@ -537,7 +537,7 @@ module Lithic
         WIRE_INBOUND_ADMIN: :WIRE_INBOUND_ADMIN
         WIRE_OUTBOUND_PAYMENT: :WIRE_OUTBOUND_PAYMENT
         WIRE_OUTBOUND_ADMIN: :WIRE_OUTBOUND_ADMIN
-        WIRE_DRAWDOWN_REQUEST: :WIRE_DRAWDOWN_REQUEST
+        WIRE_INBOUND_DRAWDOWN_REQUEST: :WIRE_INBOUND_DRAWDOWN_REQUEST
 
         def self?.values: -> ::Array[Lithic::Models::Payment::type_]
       end
