SDK regeneration

.fern/metadata.json

@@ -23,7 +23,7 @@
       }
     ]
   },
-  "originGitCommit": "ba014d4647e50fa5b7a5eefb6a2a4bdff847b683",
+  "originGitCommit": "067e0ade1fa8f371bf795e252e5c2f5049e8756d",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
   "requestedVersion": "1.4.2",

reference.md

@@ -6680,7 +6680,7 @@ client.credits.acquire_credit_lease(
 <dl>
 <dd>
 
-**expires_at:** `typing.Optional[datetime.datetime]` 
+**expires_at:** `typing.Optional[datetime.datetime]` — When the hold lapses if the lease is never released; defaults to five minutes from now and may be at most one hour out. The unspent hold is refunded on expiry
 
 </dd>
 </dl>
@@ -6756,7 +6756,7 @@ client.credits.extend_credit_lease(
 <dl>
 <dd>
 
-**expires_at:** `typing.Optional[datetime.datetime]` 
+**expires_at:** `typing.Optional[datetime.datetime]` — Pushes the lease's expiry out; may be at most one hour from now. Leave unset to keep the expiry the lease already has
 
 </dd>
 </dl>
@@ -21950,15 +21950,23 @@ client.features.check_and_reserve_flag(
 <dl>
 <dd>
 
-**preflight:** `typing.Optional[PreflightRequestBody]` — Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is quantity times the entitlement's consumption rate
+**idempotency_key:** `typing.Optional[str]` — A caller-chosen key for safe retries: a second request with the same key returns the original reservation instead of taking another hold
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**preflight:** `typing.Optional[PreflightRequestBody]` — Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is the entitlement's consumption rate times quantity, or, when quantity is omitted, times the usage stated here
 
 </dd>
 </dl>
 
 <dl>
 <dd>
 
-**quantity:** `typing.Optional[float]` — Units of the feature the operation will consume; defaults to 1. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event
+**quantity:** `typing.Optional[float]` — Units of the feature the operation will consume. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event. When it is omitted the units come from preflight.event_usage.quantity, if that event subtype is the entitlement's, else from preflight.usage, else 1
 
 </dd>
 </dl>

src/schematic/__init__.py

@@ -182,6 +182,7 @@
         CreditReservationResponseData,
         CreditSpendPolicyResponseData,
         CreditSpendPolicyScope,
+        CreditTransferReason,
         CreditTransferResponseData,
         CreditTransferView,
         CreditTriggerConfig,
@@ -1228,6 +1229,7 @@
     "CreditReservationResponseData": ".types",
     "CreditSpendPolicyResponseData": ".types",
     "CreditSpendPolicyScope": ".types",
+    "CreditTransferReason": ".types",
     "CreditTransferResponseData": ".types",
     "CreditTransferView": ".types",
     "CreditTriggerConfig": ".types",
@@ -2159,6 +2161,7 @@ def __dir__():
     "CreditReservationResponseData",
     "CreditSpendPolicyResponseData",
     "CreditSpendPolicyScope",
+    "CreditTransferReason",
     "CreditTransferResponseData",
     "CreditTransferView",
     "CreditTriggerConfig",

src/schematic/credits/client.py

@@ -1152,6 +1152,7 @@ def acquire_credit_lease(
         requested_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            When the hold lapses if the lease is never released; defaults to five minutes from now and may be at most one hour out. The unspent hold is refunded on expiry
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1201,6 +1202,7 @@ def extend_credit_lease(
         additional_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            Pushes the lease's expiry out; may be at most one hour from now. Leave unset to keep the expiry the lease already has
 
         idempotency_key : typing.Optional[str]
             A caller-chosen key for safe retries: a second request with the same key returns the lease as it stands instead of growing it again. Keys are unique per environment across every extend
@@ -3589,6 +3591,7 @@ async def acquire_credit_lease(
         requested_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            When the hold lapses if the lease is never released; defaults to five minutes from now and may be at most one hour out. The unspent hold is refunded on expiry
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -3646,6 +3649,7 @@ async def extend_credit_lease(
         additional_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            Pushes the lease's expiry out; may be at most one hour from now. Leave unset to keep the expiry the lease already has
 
         idempotency_key : typing.Optional[str]
             A caller-chosen key for safe retries: a second request with the same key returns the lease as it stands instead of growing it again. Keys are unique per environment across every extend

src/schematic/credits/raw_client.py

@@ -2472,6 +2472,7 @@ def acquire_credit_lease(
         requested_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            When the hold lapses if the lease is never released; defaults to five minutes from now and may be at most one hour out. The unspent hold is refunded on expiry
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -2603,6 +2604,7 @@ def extend_credit_lease(
         additional_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            Pushes the lease's expiry out; may be at most one hour from now. Leave unset to keep the expiry the lease already has
 
         idempotency_key : typing.Optional[str]
             A caller-chosen key for safe retries: a second request with the same key returns the lease as it stands instead of growing it again. Keys are unique per environment across every extend
@@ -7359,6 +7361,7 @@ async def acquire_credit_lease(
         requested_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            When the hold lapses if the lease is never released; defaults to five minutes from now and may be at most one hour out. The unspent hold is refunded on expiry
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -7490,6 +7493,7 @@ async def extend_credit_lease(
         additional_amount : float
 
         expires_at : typing.Optional[dt.datetime]
+            Pushes the lease's expiry out; may be at most one hour from now. Leave unset to keep the expiry the lease already has
 
         idempotency_key : typing.Optional[str]
             A caller-chosen key for safe retries: a second request with the same key returns the lease as it stands instead of growing it again. Keys are unique per environment across every extend

src/schematic/features/client.py

@@ -897,6 +897,7 @@ def check_and_reserve_flag(
         *,
         company: typing.Optional[typing.Dict[str, str]] = OMIT,
         expires_at: typing.Optional[dt.datetime] = OMIT,
+        idempotency_key: typing.Optional[str] = OMIT,
         preflight: typing.Optional[PreflightRequestBody] = OMIT,
         quantity: typing.Optional[float] = OMIT,
         user: typing.Optional[typing.Dict[str, str]] = OMIT,
@@ -913,11 +914,14 @@ def check_and_reserve_flag(
         expires_at : typing.Optional[dt.datetime]
             When the hold lapses if no track event settles it; defaults to one minute from now and may be at most one hour out. The unspent hold is refunded on expiry
 
+        idempotency_key : typing.Optional[str]
+            A caller-chosen key for safe retries: a second request with the same key returns the original reservation instead of taking another hold
+
         preflight : typing.Optional[PreflightRequestBody]
-            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is quantity times the entitlement's consumption rate
+            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is the entitlement's consumption rate times quantity, or, when quantity is omitted, times the usage stated here
 
         quantity : typing.Optional[float]
-            Units of the feature the operation will consume; defaults to 1. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event
+            Units of the feature the operation will consume. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event. When it is omitted the units come from preflight.event_usage.quantity, if that event subtype is the entitlement's, else from preflight.usage, else 1
 
         user : typing.Optional[typing.Dict[str, str]]
 
@@ -944,6 +948,7 @@ def check_and_reserve_flag(
             key,
             company=company,
             expires_at=expires_at,
+            idempotency_key=idempotency_key,
             preflight=preflight,
             quantity=quantity,
             user=user,
@@ -2054,6 +2059,7 @@ async def check_and_reserve_flag(
         *,
         company: typing.Optional[typing.Dict[str, str]] = OMIT,
         expires_at: typing.Optional[dt.datetime] = OMIT,
+        idempotency_key: typing.Optional[str] = OMIT,
         preflight: typing.Optional[PreflightRequestBody] = OMIT,
         quantity: typing.Optional[float] = OMIT,
         user: typing.Optional[typing.Dict[str, str]] = OMIT,
@@ -2070,11 +2076,14 @@ async def check_and_reserve_flag(
         expires_at : typing.Optional[dt.datetime]
             When the hold lapses if no track event settles it; defaults to one minute from now and may be at most one hour out. The unspent hold is refunded on expiry
 
+        idempotency_key : typing.Optional[str]
+            A caller-chosen key for safe retries: a second request with the same key returns the original reservation instead of taking another hold
+
         preflight : typing.Optional[PreflightRequestBody]
-            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is quantity times the entitlement's consumption rate
+            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is the entitlement's consumption rate times quantity, or, when quantity is omitted, times the usage stated here
 
         quantity : typing.Optional[float]
-            Units of the feature the operation will consume; defaults to 1. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event
+            Units of the feature the operation will consume. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event. When it is omitted the units come from preflight.event_usage.quantity, if that event subtype is the entitlement's, else from preflight.usage, else 1
 
         user : typing.Optional[typing.Dict[str, str]]
 
@@ -2109,6 +2118,7 @@ async def main() -> None:
             key,
             company=company,
             expires_at=expires_at,
+            idempotency_key=idempotency_key,
             preflight=preflight,
             quantity=quantity,
             user=user,

src/schematic/features/raw_client.py

@@ -1829,6 +1829,7 @@ def check_and_reserve_flag(
         *,
         company: typing.Optional[typing.Dict[str, str]] = OMIT,
         expires_at: typing.Optional[dt.datetime] = OMIT,
+        idempotency_key: typing.Optional[str] = OMIT,
         preflight: typing.Optional[PreflightRequestBody] = OMIT,
         quantity: typing.Optional[float] = OMIT,
         user: typing.Optional[typing.Dict[str, str]] = OMIT,
@@ -1845,11 +1846,14 @@ def check_and_reserve_flag(
         expires_at : typing.Optional[dt.datetime]
             When the hold lapses if no track event settles it; defaults to one minute from now and may be at most one hour out. The unspent hold is refunded on expiry
 
+        idempotency_key : typing.Optional[str]
+            A caller-chosen key for safe retries: a second request with the same key returns the original reservation instead of taking another hold
+
         preflight : typing.Optional[PreflightRequestBody]
-            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is quantity times the entitlement's consumption rate
+            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is the entitlement's consumption rate times quantity, or, when quantity is omitted, times the usage stated here
 
         quantity : typing.Optional[float]
-            Units of the feature the operation will consume; defaults to 1. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event
+            Units of the feature the operation will consume. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event. When it is omitted the units come from preflight.event_usage.quantity, if that event subtype is the entitlement's, else from preflight.usage, else 1
 
         user : typing.Optional[typing.Dict[str, str]]
 
@@ -1867,6 +1871,7 @@ def check_and_reserve_flag(
             json={
                 "company": company,
                 "expires_at": expires_at,
+                "idempotency_key": idempotency_key,
                 "preflight": convert_and_respect_annotation_metadata(
                     object_=preflight, annotation=PreflightRequestBody, direction="write"
                 ),
@@ -4093,6 +4098,7 @@ async def check_and_reserve_flag(
         *,
         company: typing.Optional[typing.Dict[str, str]] = OMIT,
         expires_at: typing.Optional[dt.datetime] = OMIT,
+        idempotency_key: typing.Optional[str] = OMIT,
         preflight: typing.Optional[PreflightRequestBody] = OMIT,
         quantity: typing.Optional[float] = OMIT,
         user: typing.Optional[typing.Dict[str, str]] = OMIT,
@@ -4109,11 +4115,14 @@ async def check_and_reserve_flag(
         expires_at : typing.Optional[dt.datetime]
             When the hold lapses if no track event settles it; defaults to one minute from now and may be at most one hour out. The unspent hold is refunded on expiry
 
+        idempotency_key : typing.Optional[str]
+            A caller-chosen key for safe retries: a second request with the same key returns the original reservation instead of taking another hold
+
         preflight : typing.Optional[PreflightRequestBody]
-            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is quantity times the entitlement's consumption rate
+            Hypothetical usage to evaluate the flag against. When credit_cost names the entitlement's credit, that cost is what gets held; otherwise the hold is the entitlement's consumption rate times quantity, or, when quantity is omitted, times the usage stated here
 
         quantity : typing.Optional[float]
-            Units of the feature the operation will consume; defaults to 1. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event
+            Units of the feature the operation will consume. Sets the hold size together with the entitlement's consumption rate, and is echoed back on the reservation for the settling track event. When it is omitted the units come from preflight.event_usage.quantity, if that event subtype is the entitlement's, else from preflight.usage, else 1
 
         user : typing.Optional[typing.Dict[str, str]]
 
@@ -4131,6 +4140,7 @@ async def check_and_reserve_flag(
             json={
                 "company": company,
                 "expires_at": expires_at,
+                "idempotency_key": idempotency_key,
                 "preflight": convert_and_respect_annotation_metadata(
                     object_=preflight, annotation=PreflightRequestBody, direction="write"
                 ),

src/schematic/types/__init__.py

@@ -185,6 +185,7 @@
     from .credit_reservation_response_data import CreditReservationResponseData
     from .credit_spend_policy_response_data import CreditSpendPolicyResponseData
     from .credit_spend_policy_scope import CreditSpendPolicyScope
+    from .credit_transfer_reason import CreditTransferReason
     from .credit_transfer_response_data import CreditTransferResponseData
     from .credit_transfer_view import CreditTransferView
     from .credit_trigger_config import CreditTriggerConfig
@@ -668,6 +669,7 @@
     "CreditReservationResponseData": ".credit_reservation_response_data",
     "CreditSpendPolicyResponseData": ".credit_spend_policy_response_data",
     "CreditSpendPolicyScope": ".credit_spend_policy_scope",
+    "CreditTransferReason": ".credit_transfer_reason",
     "CreditTransferResponseData": ".credit_transfer_response_data",
     "CreditTransferView": ".credit_transfer_view",
     "CreditTriggerConfig": ".credit_trigger_config",
@@ -1171,6 +1173,7 @@ def __dir__():
     "CreditReservationResponseData",
     "CreditSpendPolicyResponseData",
     "CreditSpendPolicyScope",
+    "CreditTransferReason",
     "CreditTransferResponseData",
     "CreditTransferView",
     "CreditTriggerConfig",

src/schematic/types/billing_credit_grant_reason.py

@@ -4,7 +4,15 @@
 
 BillingCreditGrantReason = typing.Union[
     typing.Literal[
-        "adjustment", "billing_credit_auto_topup", "free", "plan", "postpaid_overdraft", "purchased", "rollover"
+        "adjustment",
+        "billing_credit_auto_topup",
+        "free",
+        "plan",
+        "postpaid_forgiven",
+        "postpaid_overdraft",
+        "postpaid_settlement",
+        "purchased",
+        "rollover",
     ],
     typing.Any,
 ]

src/schematic/types/billing_credit_response_data.py

@@ -7,6 +7,7 @@
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
 from .billing_credit_burn_strategy import BillingCreditBurnStrategy
 from .billing_credit_expiry_unit import BillingCreditExpiryUnit
+from .billing_credit_ledger_authority import BillingCreditLedgerAuthority
 from .billing_credit_rollover_policy import BillingCreditRolloverPolicy
 from .billing_price_response_data import BillingPriceResponseData
 from .billing_product_response_data import BillingProductResponseData
@@ -24,6 +25,7 @@ class BillingCreditResponseData(UniversalBaseModel):
     description: str
     icon: typing.Optional[str] = None
     id: str
+    ledger_authority: BillingCreditLedgerAuthority
     name: str
     plural_name: typing.Optional[str] = None
     price: typing.Optional[BillingPriceResponseData] = None