feat(api): add WIRE_DRAWDOWN_REQUEST transfer type

stainless-app[bot] · stainless-app[bot] · commit 832895fdf5d4 · 2025-12-23T09:32:17.000Z
docs(api): clarify description of token /  retry_token when it serves as idempotency key
feat(api): remove unnecessary X-Lithic-Pagination header
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-1916ba0e95ce59f0feeebd6f3d2130990c812be7eabcda6e23c5fa096db912c7.yml
-openapi_spec_hash: b465e7cb5c2dee36b5bdc6d540b2a530
-config_hash: a8a802e2c916a5d36a025bf64ab55ee7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-854de7cc8f79e150ffe98f038ce9f39367010b2bdfffc9992be2738697dc4880.yml
+openapi_spec_hash: fd471b20f3eda1e00cdebf028cbfe867
+config_hash: 9dddee5f7af579864599849cb28a0770
diff --git a/lib/lithic/client.rb b/lib/lithic/client.rb
@@ -181,19 +181,14 @@ def initialize(
         raise ArgumentError.new("api_key is required, and can be set via environ: \"LITHIC_API_KEY\"")
       end
 
-      headers = {
-        "x-lithic-pagination" => "cursor"
-      }
-
       @api_key = api_key.to_s
 
       super(
         base_url: base_url,
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay,
-        headers: headers
+        max_retry_delay: max_retry_delay
       )
 
       @accounts = Lithic::Resources::Accounts.new(client: self)
diff --git a/lib/lithic/models/book_transfer_retry_params.rb b/lib/lithic/models/book_transfer_retry_params.rb
@@ -8,13 +8,17 @@ class BookTransferRetryParams < Lithic::Internal::Type::BaseModel
       include Lithic::Internal::Type::RequestParameters
 
       # @!attribute retry_token
-      #   Globally unique identifier for the retry.
+      #   Customer-provided token that will serve as an idempotency token. This token will
+      #   become the transaction token.
       #
       #   @return [String]
       required :retry_token, String
 
       # @!method initialize(retry_token:, request_options: {})
-      #   @param retry_token [String] Globally unique identifier for the retry.
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::BookTransferRetryParams} for more details.
+      #
+      #   @param retry_token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
       #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
     end
diff --git a/lib/lithic/models/external_payment_create_params.rb b/lib/lithic/models/external_payment_create_params.rb
@@ -33,6 +33,8 @@ class ExternalPaymentCreateParams < Lithic::Internal::Type::BaseModel
       required :payment_type, enum: -> { Lithic::ExternalPaymentCreateParams::PaymentType }
 
       # @!attribute token
+      #   Customer-provided token that will serve as an idempotency token. This token will
+      #   become the transaction token.
       #
       #   @return [String, nil]
       optional :token, String
@@ -53,15 +55,27 @@ class ExternalPaymentCreateParams < Lithic::Internal::Type::BaseModel
       optional :user_defined_id, String
 
       # @!method initialize(amount:, category:, effective_date:, financial_account_token:, payment_type:, token: nil, memo: nil, progress_to: nil, user_defined_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::ExternalPaymentCreateParams} for more details.
+      #
       #   @param amount [Integer]
+      #
       #   @param category [Symbol, Lithic::Models::ExternalPaymentCreateParams::Category]
+      #
       #   @param effective_date [Date]
+      #
       #   @param financial_account_token [String]
+      #
       #   @param payment_type [Symbol, Lithic::Models::ExternalPaymentCreateParams::PaymentType]
-      #   @param token [String]
+      #
+      #   @param token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
       #   @param memo [String]
+      #
       #   @param progress_to [Symbol, Lithic::Models::ExternalPaymentCreateParams::ProgressTo]
+      #
       #   @param user_defined_id [String]
+      #
       #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
 
       module Category
diff --git a/lib/lithic/models/management_operation_create_params.rb b/lib/lithic/models/management_operation_create_params.rb
@@ -38,6 +38,8 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel
       required :financial_account_token, String
 
       # @!attribute token
+      #   Customer-provided token that will serve as an idempotency token. This token will
+      #   become the transaction token.
       #
       #   @return [String, nil]
       optional :token, String
@@ -64,6 +66,9 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel
       optional :user_defined_id, String
 
       # @!method initialize(amount:, category:, direction:, effective_date:, event_type:, financial_account_token:, token: nil, memo: nil, on_closed_account: nil, subtype: nil, user_defined_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::ManagementOperationCreateParams} for more details.
+      #
       #   @param amount [Integer]
       #
       #   @param category [Symbol, Lithic::Models::ManagementOperationCreateParams::Category]
@@ -76,7 +81,7 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel
       #
       #   @param financial_account_token [String]
       #
-      #   @param token [String]
+      #   @param token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
       #   @param memo [String]
       #
diff --git a/lib/lithic/models/payment.rb b/lib/lithic/models/payment.rb
@@ -650,6 +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
 
         # @!method self.values
         #   @return [Array<Symbol>]
diff --git a/lib/lithic/resources/book_transfers.rb b/lib/lithic/resources/book_transfers.rb
@@ -113,13 +113,16 @@ def list(params = {})
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::BookTransferRetryParams} for more details.
+      #
       # Retry a book transfer that has been declined
       #
       # @overload retry_(book_transfer_token, retry_token:, request_options: {})
       #
       # @param book_transfer_token [String] Token of the book transfer to retry
       #
-      # @param retry_token [String] Globally unique identifier for the retry.
+      # @param retry_token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
diff --git a/lib/lithic/resources/external_payments.rb b/lib/lithic/resources/external_payments.rb
@@ -3,19 +3,31 @@
 module Lithic
   module Resources
     class ExternalPayments
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::ExternalPaymentCreateParams} for more details.
+      #
       # Create external payment
       #
       # @overload create(amount:, category:, effective_date:, financial_account_token:, payment_type:, token: nil, memo: nil, progress_to: nil, user_defined_id: nil, request_options: {})
       #
       # @param amount [Integer]
+      #
       # @param category [Symbol, Lithic::Models::ExternalPaymentCreateParams::Category]
+      #
       # @param effective_date [Date]
+      #
       # @param financial_account_token [String]
+      #
       # @param payment_type [Symbol, Lithic::Models::ExternalPaymentCreateParams::PaymentType]
-      # @param token [String]
+      #
+      # @param token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
       # @param memo [String]
+      #
       # @param progress_to [Symbol, Lithic::Models::ExternalPaymentCreateParams::ProgressTo]
+      #
       # @param user_defined_id [String]
+      #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ExternalPayment]
diff --git a/lib/lithic/resources/management_operations.rb b/lib/lithic/resources/management_operations.rb
@@ -3,6 +3,9 @@
 module Lithic
   module Resources
     class ManagementOperations
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::ManagementOperationCreateParams} for more details.
+      #
       # Create management operation
       #
       # @overload create(amount:, category:, direction:, effective_date:, event_type:, financial_account_token:, token: nil, memo: nil, on_closed_account: nil, subtype: nil, user_defined_id: nil, request_options: {})
@@ -19,7 +22,7 @@ class ManagementOperations
       #
       # @param financial_account_token [String]
       #
-      # @param token [String]
+      # @param token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
       # @param memo [String]
       #
diff --git a/rbi/lithic/models/book_transfer_retry_params.rbi b/rbi/lithic/models/book_transfer_retry_params.rbi
@@ -11,7 +11,8 @@ module Lithic
           T.any(Lithic::BookTransferRetryParams, Lithic::Internal::AnyHash)
         end
 
-      # Globally unique identifier for the retry.
+      # Customer-provided token that will serve as an idempotency token. This token will
+      # become the transaction token.
       sig { returns(String) }
       attr_accessor :retry_token
 
@@ -22,7 +23,8 @@ module Lithic
         ).returns(T.attached_class)
       end
       def self.new(
-        # Globally unique identifier for the retry.
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         retry_token:,
         request_options: {}
       )
diff --git a/rbi/lithic/models/external_payment_create_params.rbi b/rbi/lithic/models/external_payment_create_params.rbi
@@ -28,6 +28,8 @@ module Lithic
       end
       attr_accessor :payment_type
 
+      # Customer-provided token that will serve as an idempotency token. This token will
+      # become the transaction token.
       sig { returns(T.nilable(String)) }
       attr_reader :token
 
@@ -82,6 +84,8 @@ module Lithic
         effective_date:,
         financial_account_token:,
         payment_type:,
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         token: nil,
         memo: nil,
         progress_to: nil,
diff --git a/rbi/lithic/models/management_operation_create_params.rbi b/rbi/lithic/models/management_operation_create_params.rbi
@@ -38,6 +38,8 @@ module Lithic
       sig { returns(String) }
       attr_accessor :financial_account_token
 
+      # Customer-provided token that will serve as an idempotency token. This token will
+      # become the transaction token.
       sig { returns(T.nilable(String)) }
       attr_reader :token
 
@@ -106,6 +108,8 @@ module Lithic
         effective_date:,
         event_type:,
         financial_account_token:,
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         token: nil,
         memo: nil,
         # What to do if the financial account is closed when posting an operation
diff --git a/rbi/lithic/models/payment.rbi b/rbi/lithic/models/payment.rbi
@@ -1061,6 +1061,8 @@ 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)
 
         sig { override.returns(T::Array[Lithic::Payment::Type::TaggedSymbol]) }
         def self.values
diff --git a/rbi/lithic/resources/book_transfers.rbi b/rbi/lithic/resources/book_transfers.rbi
@@ -121,7 +121,8 @@ module Lithic
       def retry_(
         # Token of the book transfer to retry
         book_transfer_token,
-        # Globally unique identifier for the retry.
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         retry_token:,
         request_options: {}
       )
diff --git a/rbi/lithic/resources/external_payments.rbi b/rbi/lithic/resources/external_payments.rbi
@@ -26,6 +26,8 @@ module Lithic
         effective_date:,
         financial_account_token:,
         payment_type:,
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         token: nil,
         memo: nil,
         progress_to: nil,
diff --git a/rbi/lithic/resources/management_operations.rbi b/rbi/lithic/resources/management_operations.rbi
@@ -30,6 +30,8 @@ module Lithic
         effective_date:,
         event_type:,
         financial_account_token:,
+        # Customer-provided token that will serve as an idempotency token. This token will
+        # become the transaction token.
         token: nil,
         memo: nil,
         # What to do if the financial account is closed when posting an operation
diff --git a/sig/lithic/models/payment.rbs b/sig/lithic/models/payment.rbs
@@ -524,6 +524,7 @@ module Lithic
         | :WIRE_INBOUND_ADMIN
         | :WIRE_OUTBOUND_PAYMENT
         | :WIRE_OUTBOUND_ADMIN
+        | :WIRE_DRAWDOWN_REQUEST
 
       module Type
         extend Lithic::Internal::Type::Enum
@@ -536,6 +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
 
         def self?.values: -> ::Array[Lithic::Models::Payment::type_]
       end

Original file line number	Diff line number	Diff line change
`@@ -38,6 +38,8 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel`
`38`	`38`	`required :financial_account_token, String`
`39`	`39`
`40`	`40`	`# @!attribute token`
	`41`	`+ # Customer-provided token that will serve as an idempotency token. This token will`
	`42`	`+ # become the transaction token.`
`41`	`43`	`#`
`42`	`44`	`# @return [String, nil]`
`43`	`45`	`optional :token, String`
`@@ -64,6 +66,9 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel`
`64`	`66`	`optional :user_defined_id, String`
`65`	`67`
`66`	`68`	`# @!method initialize(amount:, category:, direction:, effective_date:, event_type:, financial_account_token:, token: nil, memo: nil, on_closed_account: nil, subtype: nil, user_defined_id: nil, request_options: {})`
	`69`	`+ # Some parameter documentations has been truncated, see`
	`70`	`+ # {Lithic::Models::ManagementOperationCreateParams} for more details.`
	`71`	`+ #`
`67`	`72`	`# @param amount [Integer]`
`68`	`73`	`#`
`69`	`74`	`# @param category [Symbol, Lithic::Models::ManagementOperationCreateParams::Category]`
`@@ -76,7 +81,7 @@ class ManagementOperationCreateParams < Lithic::Internal::Type::BaseModel`
`76`	`81`	`#`
`77`	`82`	`# @param financial_account_token [String]`
`78`	`83`	`#`
`79`		`- # @param token [String]`
	`84`	`+ # @param token [String] Customer-provided token that will serve as an idempotency token. This token will`
`80`	`85`	`#`
`81`	`86`	`# @param memo [String]`
`82`	`87`	`#`
Original file line number	Diff line number	Diff line change
`@@ -113,13 +113,16 @@ def list(params = {})`
`113`	`113`	`)`
`114`	`114`	`end`
`115`	`115`
	`116`	`+ # Some parameter documentations has been truncated, see`
	`117`	`+ # {Lithic::Models::BookTransferRetryParams} for more details.`
	`118`	`+ #`
`116`	`119`	`# Retry a book transfer that has been declined`
`117`	`120`	`#`
`118`	`121`	`# @overload retry_(book_transfer_token, retry_token:, request_options: {})`
`119`	`122`	`#`
`120`	`123`	`# @param book_transfer_token [String] Token of the book transfer to retry`
`121`	`124`	`#`
`122`		`- # @param retry_token [String] Globally unique identifier for the retry.`
	`125`	`+ # @param retry_token [String] Customer-provided token that will serve as an idempotency token. This token will`
`123`	`126`	`#`
`124`	`127`	`# @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]`
`125`	`128`	`#`
Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,9 @@`
`3`	`3`	`module Lithic`
`4`	`4`	`module Resources`
`5`	`5`	`class ManagementOperations`
	`6`	`+ # Some parameter documentations has been truncated, see`
	`7`	`+ # {Lithic::Models::ManagementOperationCreateParams} for more details.`
	`8`	`+ #`
`6`	`9`	`# Create management operation`
`7`	`10`	`#`
`8`	`11`	`# @overload create(amount:, category:, direction:, effective_date:, event_type:, financial_account_token:, token: nil, memo: nil, on_closed_account: nil, subtype: nil, user_defined_id: nil, request_options: {})`
`@@ -19,7 +22,7 @@ class ManagementOperations`
`19`	`22`	`#`
`20`	`23`	`# @param financial_account_token [String]`
`21`	`24`	`#`
`22`		`- # @param token [String]`
	`25`	`+ # @param token [String] Customer-provided token that will serve as an idempotency token. This token will`
`23`	`26`	`#`
`24`	`27`	`# @param memo [String]`
`25`	`28`	`#`