release: 2.8.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.7.0"
+  ".": "2.8.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-9a6d840deb9e30caf68354e884cb2c72ff6ca21cfbefb5ed0ca6187932c9cd62.yml
-openapi_spec_hash: ce61ace110680a502bdccf396b2a4d88
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-d7a5aa80f0d4940c2d9994e1a72d27e0a22ac2431e4dab6354ca628457c7c790.yml
+openapi_spec_hash: ec74d859d1bfd431ea7210f800e02c8d
 config_hash: 9ae56f40cec7304896138bfad5caf748

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.8.0 (2026-08-17)
+
+Full Changelog: [v2.7.0...v2.8.0](https://github.com/Finch-API/finch-api-python/compare/v2.7.0...v2.8.0)
+
+### Features
+
+* **api:** api update ([eedea2e](https://github.com/Finch-API/finch-api-python/commit/eedea2e6a4bf4089ba9a8a0b87735930a91f7c59))
+* **api:** api update ([4e0de6d](https://github.com/Finch-API/finch-api-python/commit/4e0de6d2b7a5cd767d82434f051d2e831c3f447a))
+* **api:** api update ([d86cd47](https://github.com/Finch-API/finch-api-python/commit/d86cd47716a2f92779444fa7deeb454bd13c805e))
+
 ## 2.7.0 (2026-08-07)
 
 Full Changelog: [v2.6.0...v2.7.0](https://github.com/Finch-API/finch-api-python/compare/v2.6.0...v2.7.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "finch-api"
-version = "2.7.0"
+version = "2.8.0"
 description = "The official Python library for the Finch API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/finch/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "finch"
-__version__ = "2.7.0"  # x-release-please-version
+__version__ = "2.8.0"  # x-release-please-version

src/finch/resources/connect/sessions.py

@@ -68,6 +68,7 @@ def new(
         integration: Optional[session_new_params.Integration] | Omit = omit,
         manual: Optional[bool] | Omit = omit,
         minutes_to_expire: Optional[float] | Omit = omit,
+        recordkeeping: Optional[session_new_params.Recordkeeping] | Omit = omit,
         redirect_uri: Optional[str] | Omit = omit,
         sandbox: Optional[Literal["finch", "provider"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -98,6 +99,10 @@ def new(
           minutes_to_expire: The number of minutes until the session expires (defaults to 129,600, which is
               90 days)
 
+          recordkeeping: Optional recordkeeping configuration. Can only be provided when the
+              `recordkeeping` product is requested. Currently supports `recordkeeper` set to
+              `voya`, `empower`, `fidelity`, or `transamerica`.
+
           redirect_uri: The URI to redirect to after the Connect flow is completed
 
           sandbox: Sandbox mode for testing
@@ -121,6 +126,7 @@ def new(
                     "integration": integration,
                     "manual": manual,
                     "minutes_to_expire": minutes_to_expire,
+                    "recordkeeping": recordkeeping,
                     "redirect_uri": redirect_uri,
                     "sandbox": sandbox,
                 },
@@ -262,6 +268,7 @@ async def new(
         integration: Optional[session_new_params.Integration] | Omit = omit,
         manual: Optional[bool] | Omit = omit,
         minutes_to_expire: Optional[float] | Omit = omit,
+        recordkeeping: Optional[session_new_params.Recordkeeping] | Omit = omit,
         redirect_uri: Optional[str] | Omit = omit,
         sandbox: Optional[Literal["finch", "provider"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -292,6 +299,10 @@ async def new(
           minutes_to_expire: The number of minutes until the session expires (defaults to 129,600, which is
               90 days)
 
+          recordkeeping: Optional recordkeeping configuration. Can only be provided when the
+              `recordkeeping` product is requested. Currently supports `recordkeeper` set to
+              `voya`, `empower`, `fidelity`, or `transamerica`.
+
           redirect_uri: The URI to redirect to after the Connect flow is completed
 
           sandbox: Sandbox mode for testing
@@ -315,6 +326,7 @@ async def new(
                     "integration": integration,
                     "manual": manual,
                     "minutes_to_expire": minutes_to_expire,
+                    "recordkeeping": recordkeeping,
                     "redirect_uri": redirect_uri,
                     "sandbox": sandbox,
                 },

src/finch/types/connect/session_new_params.py

@@ -5,7 +5,7 @@
 from typing import List, Optional
 from typing_extensions import Literal, Required, TypedDict
 
-__all__ = ["SessionNewParams", "Integration"]
+__all__ = ["SessionNewParams", "Integration", "Recordkeeping"]
 
 
 class SessionNewParams(TypedDict, total=False):
@@ -56,6 +56,13 @@ class SessionNewParams(TypedDict, total=False):
     90 days)
     """
 
+    recordkeeping: Optional[Recordkeeping]
+    """Optional recordkeeping configuration.
+
+    Can only be provided when the `recordkeeping` product is requested. Currently
+    supports `recordkeeper` set to `voya`, `empower`, `fidelity`, or `transamerica`.
+    """
+
     redirect_uri: Optional[str]
     """The URI to redirect to after the Connect flow is completed"""
 
@@ -71,3 +78,16 @@ class Integration(TypedDict, total=False):
 
     auth_method: Optional[Literal["assisted", "credential", "oauth", "api_token"]]
     """The authentication method to use"""
+
+
+class Recordkeeping(TypedDict, total=False):
+    """Optional recordkeeping configuration.
+
+    Can only be provided when the `recordkeeping` product is requested. Currently supports `recordkeeper` set to `voya`, `empower`, `fidelity`, or `transamerica`.
+    """
+
+    recordkeeper: Required[Literal["voya", "empower", "fidelity", "transamerica"]]
+    """The recordkeeper to configure for this connection"""
+
+    plan_id: Optional[str]
+    """The plan identifier used by the recordkeeper"""

tests/api_resources/connect/test_sessions.py

@@ -44,6 +44,10 @@ def test_method_new_with_all_params(self, client: Finch) -> None:
             },
             manual=True,
             minutes_to_expire=1,
+            recordkeeping={
+                "recordkeeper": "voya",
+                "plan_id": "x",
+            },
             redirect_uri="redirect_uri",
             sandbox="finch",
         )
@@ -154,6 +158,10 @@ async def test_method_new_with_all_params(self, async_client: AsyncFinch) -> Non
             },
             manual=True,
             minutes_to_expire=1,
+            recordkeeping={
+                "recordkeeper": "voya",
+                "plan_id": "x",
+            },
             redirect_uri="redirect_uri",
             sandbox="finch",
         )