feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-6190639c909b62f2e182a32dc56a80a87ca470e8970efd6ce8d3d7bd659d237c.yml
-openapi_spec_hash: c4078fa61a4ab0b480a2c7b40e495104
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-970ab04a97244c68824c0c52e06925cba14fb7dbfc36c03167c1afe74cd1b150.yml
+openapi_spec_hash: 315e7859c3f77311261fb824b74a8247
 config_hash: f2846563903bf75ab0858872154df0f7

src/finch/types/hris/benefits/individual_benefit.py

@@ -23,18 +23,32 @@
 
 class BodyUnionMember0CompanyContributionUnionMember0(BaseModel):
     amount: int
-    """Contribution amount in cents."""
+    """
+    Contribution amount in cents (for type=fixed) or basis points (for type=percent,
+    where 100 = 1%). Not used for type=tiered.
+    """
 
     type: Literal["fixed"]
-    """Fixed contribution type."""
+    """Contribution type.
+
+    Supported values: "fixed" (amount in cents), "percent" (amount in basis points),
+    or "tiered" (multi-tier matching).
+    """
 
 
 class BodyUnionMember0CompanyContributionUnionMember1(BaseModel):
     amount: int
-    """Contribution amount in basis points (1/100th of a percent)."""
+    """
+    Contribution amount in cents (for type=fixed) or basis points (for type=percent,
+    where 100 = 1%). Not used for type=tiered.
+    """
 
     type: Literal["percent"]
-    """Percentage contribution type."""
+    """Contribution type.
+
+    Supported values: "fixed" (amount in cents), "percent" (amount in basis points),
+    or "tiered" (multi-tier matching).
+    """
 
 
 class BodyUnionMember0CompanyContributionUnionMember2Tier(BaseModel):
@@ -47,11 +61,15 @@ class BodyUnionMember0CompanyContributionUnionMember2(BaseModel):
     tiers: List[BodyUnionMember0CompanyContributionUnionMember2Tier]
     """
     Array of tier objects defining employer match tiers based on employee
-    contribution thresholds.
+    contribution thresholds. Required when type=tiered.
     """
 
     type: Literal["tiered"]
-    """Tiered contribution type (only valid for company_contribution)."""
+    """Contribution type.
+
+    Supported values: "fixed" (amount in cents), "percent" (amount in basis points),
+    or "tiered" (multi-tier matching).
+    """
 
 
 BodyUnionMember0CompanyContribution: TypeAlias = Union[
@@ -64,18 +82,32 @@ class BodyUnionMember0CompanyContributionUnionMember2(BaseModel):
 
 class BodyUnionMember0EmployeeDeductionUnionMember0(BaseModel):
     amount: int
-    """Contribution amount in cents."""
+    """
+    Contribution amount in cents (for type=fixed) or basis points (for type=percent,
+    where 100 = 1%).
+    """
 
     type: Literal["fixed"]
-    """Fixed contribution type."""
+    """Contribution type.
+
+    Supported values: "fixed" (amount in cents) or "percent" (amount in basis
+    points).
+    """
 
 
 class BodyUnionMember0EmployeeDeductionUnionMember1(BaseModel):
     amount: int
-    """Contribution amount in basis points (1/100th of a percent)."""
+    """
+    Contribution amount in cents (for type=fixed) or basis points (for type=percent,
+    where 100 = 1%).
+    """
 
     type: Literal["percent"]
-    """Percentage contribution type."""
+    """Contribution type.
+
+    Supported values: "fixed" (amount in cents) or "percent" (amount in basis
+    points).
+    """
 
 
 BodyUnionMember0EmployeeDeduction: TypeAlias = Union[
@@ -96,8 +128,18 @@ class BodyUnionMember0(BaseModel):
     """
 
     company_contribution: Optional[BodyUnionMember0CompanyContribution] = None
+    """Company contribution configuration.
+
+    Supports fixed amounts (in cents), percentage-based contributions (in basis
+    points where 100 = 1%), or tiered matching structures.
+    """
 
     employee_deduction: Optional[BodyUnionMember0EmployeeDeduction] = None
+    """Employee deduction configuration.
+
+    Supports both fixed amounts (in cents) and percentage-based contributions (in
+    basis points where 100 = 1%).
+    """
 
     hsa_contribution_limit: Optional[Literal["individual", "family"]] = None
     """Type for HSA contribution limit if the benefit is a HSA."""

src/finch/types/request_forwarding_forward_response.py

@@ -22,7 +22,7 @@ class Request(BaseModel):
     data: Union[str, Dict[str, Optional[object]], None] = None
     """The body that was specified for the forwarded request."""
 
-    headers: Optional[Dict[str, Optional[object]]] = None
+    headers: Optional[Dict[str, str]] = None
     """The HTTP headers that were specified for the forwarded request."""
 
     params: Optional[Dict[str, Optional[object]]] = None