feat(api): add WIRE_DRAWDOWN_REQUEST transfer type

docs(api): clarify description of token /  retry_token when it serves as idempotency key
feat(api): remove unnecessary X-Lithic-Pagination header

Author: stainless-app[bot]

.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

lithic-java-core/src/main/kotlin/com/lithic/api/core/ClientOptions.kt

@@ -475,7 +475,6 @@ private constructor(
             headers.put("X-Stainless-Package-Version", getPackageVersion())
             headers.put("X-Stainless-Runtime", "JRE")
             headers.put("X-Stainless-Runtime-Version", getJavaVersion())
-            headers.put("X-Lithic-Pagination", "cursor")
             apiKey.let {
                 if (!it.isEmpty()) {
                     headers.put("Authorization", it)

lithic-java-core/src/main/kotlin/com/lithic/api/models/BookTransferRetryParams.kt

@@ -32,7 +32,8 @@ private constructor(
     fun bookTransferToken(): Optional<String> = Optional.ofNullable(bookTransferToken)
 
     /**
-     * Globally unique identifier for the retry.
+     * Customer-provided token that will serve as an idempotency token. This token will become the
+     * transaction token.
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -102,7 +103,10 @@ private constructor(
          */
         fun body(body: RetryBookTransferRequest) = apply { this.body = body.toBuilder() }
 
-        /** Globally unique identifier for the retry. */
+        /**
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
+         */
         fun retryToken(retryToken: String) = apply { body.retryToken(retryToken) }
 
         /**
@@ -279,7 +283,8 @@ private constructor(
         ) : this(retryToken, mutableMapOf())
 
         /**
-         * Globally unique identifier for the retry.
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
          *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -332,7 +337,10 @@ private constructor(
                 additionalProperties = retryBookTransferRequest.additionalProperties.toMutableMap()
             }
 
-            /** Globally unique identifier for the retry. */
+            /**
+             * Customer-provided token that will serve as an idempotency token. This token will
+             * become the transaction token.
+             */
             fun retryToken(retryToken: String) = retryToken(JsonField.of(retryToken))
 
             /**

lithic-java-core/src/main/kotlin/com/lithic/api/models/ExternalPaymentCreateParams.kt

@@ -61,6 +61,9 @@ private constructor(
     fun paymentType(): ExternalPaymentDirection = body.paymentType()
 
     /**
+     * Customer-provided token that will serve as an idempotency token. This token will become the
+     * transaction token.
+     *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -270,6 +273,10 @@ private constructor(
             body.paymentType(paymentType)
         }
 
+        /**
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
+         */
         fun token(token: String) = apply { body.token(token) }
 
         /**
@@ -548,6 +555,9 @@ private constructor(
         fun paymentType(): ExternalPaymentDirection = paymentType.getRequired("payment_type")
 
         /**
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
+         *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
@@ -774,6 +784,10 @@ private constructor(
                 this.paymentType = paymentType
             }
 
+            /**
+             * Customer-provided token that will serve as an idempotency token. This token will
+             * become the transaction token.
+             */
             fun token(token: String) = token(JsonField.of(token))
 
             /**

lithic-java-core/src/main/kotlin/com/lithic/api/models/ManagementOperationCreateParams.kt

@@ -67,6 +67,9 @@ private constructor(
     fun financialAccountToken(): String = body.financialAccountToken()
 
     /**
+     * Customer-provided token that will serve as an idempotency token. This token will become the
+     * transaction token.
+     *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -313,6 +316,10 @@ private constructor(
             body.financialAccountToken(financialAccountToken)
         }
 
+        /**
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
+         */
         fun token(token: String) = apply { body.token(token) }
 
         /**
@@ -617,6 +624,9 @@ private constructor(
             financialAccountToken.getRequired("financial_account_token")
 
         /**
+         * Customer-provided token that will serve as an idempotency token. This token will become
+         * the transaction token.
+         *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
@@ -888,6 +898,10 @@ private constructor(
                 this.financialAccountToken = financialAccountToken
             }
 
+            /**
+             * Customer-provided token that will serve as an idempotency token. This token will
+             * become the transaction token.
+             */
             fun token(token: String) = token(JsonField.of(token))
 
             /**

lithic-java-core/src/main/kotlin/com/lithic/api/models/Payment.kt

@@ -4769,6 +4769,8 @@ private constructor(
 
             @JvmField val WIRE_OUTBOUND_ADMIN = of("WIRE_OUTBOUND_ADMIN")
 
+            @JvmField val WIRE_DRAWDOWN_REQUEST = of("WIRE_DRAWDOWN_REQUEST")
+
             @JvmStatic fun of(value: String) = TransferType(JsonField.of(value))
         }
 
@@ -4782,6 +4784,7 @@ private constructor(
             WIRE_INBOUND_ADMIN,
             WIRE_OUTBOUND_PAYMENT,
             WIRE_OUTBOUND_ADMIN,
+            WIRE_DRAWDOWN_REQUEST,
         }
 
         /**
@@ -4802,6 +4805,7 @@ private constructor(
             WIRE_INBOUND_ADMIN,
             WIRE_OUTBOUND_PAYMENT,
             WIRE_OUTBOUND_ADMIN,
+            WIRE_DRAWDOWN_REQUEST,
             /**
              * An enum member indicating that [TransferType] was instantiated with an unknown value.
              */
@@ -4825,6 +4829,7 @@ private constructor(
                 WIRE_INBOUND_ADMIN -> Value.WIRE_INBOUND_ADMIN
                 WIRE_OUTBOUND_PAYMENT -> Value.WIRE_OUTBOUND_PAYMENT
                 WIRE_OUTBOUND_ADMIN -> Value.WIRE_OUTBOUND_ADMIN
+                WIRE_DRAWDOWN_REQUEST -> Value.WIRE_DRAWDOWN_REQUEST
                 else -> Value._UNKNOWN
             }
 
@@ -4847,6 +4852,7 @@ private constructor(
                 WIRE_INBOUND_ADMIN -> Known.WIRE_INBOUND_ADMIN
                 WIRE_OUTBOUND_PAYMENT -> Known.WIRE_OUTBOUND_PAYMENT
                 WIRE_OUTBOUND_ADMIN -> Known.WIRE_OUTBOUND_ADMIN
+                WIRE_DRAWDOWN_REQUEST -> Known.WIRE_DRAWDOWN_REQUEST
                 else -> throw LithicInvalidDataException("Unknown TransferType: $value")
             }