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: 175
-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

README.md

@@ -338,20 +338,6 @@ On timeout, an `APITimeoutError` is thrown.
 
 Note that requests that time out are [retried twice by default](#retries).
 
-## Default Headers
-
-We automatically send the `X-Lithic-Pagination` header set to `cursor`.
-
-If you need to, you can override it by setting default headers per-request or on the client object.
-
-```python
-from lithic import Lithic
-
-client = Lithic(
-    default_headers={"X-Lithic-Pagination": "My-Custom-Value"},
-)
-```
-
 ## Advanced
 
 ### Logging

src/lithic/_client.py

@@ -417,7 +417,6 @@ def default_headers(self) -> dict[str, str | Omit]:
         return {
             **super().default_headers,
             "X-Stainless-Async": "false",
-            "X-Lithic-Pagination": "cursor",
             **self._custom_headers,
         }
 
@@ -827,7 +826,6 @@ def default_headers(self) -> dict[str, str | Omit]:
         return {
             **super().default_headers,
             "X-Stainless-Async": f"async:{get_async_library()}",
-            "X-Lithic-Pagination": "cursor",
             **self._custom_headers,
         }
 

src/lithic/resources/book_transfers.py

@@ -318,7 +318,8 @@ def retry(
         Retry a book transfer that has been declined
 
         Args:
-          retry_token: Globally unique identifier for the retry.
+          retry_token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
 
           extra_headers: Send extra headers
 
@@ -672,7 +673,8 @@ async def retry(
         Retry a book transfer that has been declined
 
         Args:
-          retry_token: Globally unique identifier for the retry.
+          retry_token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
 
           extra_headers: Send extra headers
 

src/lithic/resources/external_payments.py

@@ -74,6 +74,9 @@ def create(
         Create external payment
 
         Args:
+          token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -449,6 +452,9 @@ async def create(
         Create external payment
 
         Args:
+          token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/lithic/resources/management_operations.py

@@ -103,6 +103,9 @@ def create(
         Create management operation
 
         Args:
+          token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
+
           on_closed_account: What to do if the financial account is closed when posting an operation
 
           extra_headers: Send extra headers
@@ -380,6 +383,9 @@ async def create(
         Create management operation
 
         Args:
+          token: Customer-provided token that will serve as an idempotency token. This token will
+              become the transaction token.
+
           on_closed_account: What to do if the financial account is closed when posting an operation
 
           extra_headers: Send extra headers

src/lithic/types/book_transfer_retry_params.py

@@ -9,4 +9,7 @@
 
 class BookTransferRetryParams(TypedDict, total=False):
     retry_token: Required[str]
-    """Globally unique identifier for the retry."""
+    """Customer-provided token that will serve as an idempotency token.
+
+    This token will become the transaction token.
+    """

src/lithic/types/external_payment_create_params.py

@@ -27,6 +27,10 @@ class ExternalPaymentCreateParams(TypedDict, total=False):
     payment_type: Required[Literal["DEPOSIT", "WITHDRAWAL"]]
 
     token: str
+    """Customer-provided token that will serve as an idempotency token.
+
+    This token will become the transaction token.
+    """
 
     memo: str
 

src/lithic/types/management_operation_create_params.py

@@ -61,6 +61,10 @@ class ManagementOperationCreateParams(TypedDict, total=False):
     financial_account_token: Required[str]
 
     token: str
+    """Customer-provided token that will serve as an idempotency token.
+
+    This token will become the transaction token.
+    """
 
     memo: str
 

src/lithic/types/payment.py

@@ -253,6 +253,7 @@ class Payment(BaseModel):
             "WIRE_INBOUND_ADMIN",
             "WIRE_OUTBOUND_PAYMENT",
             "WIRE_OUTBOUND_ADMIN",
+            "WIRE_DRAWDOWN_REQUEST",
         ]
     ] = None