Direct credit consumption
- Added: an endpoint to consume credits directly from a customer’s pool, without reporting usage against a metered feature or requiring an active subscription. Complements the existing grant-credits endpoint so credit balances, grants, and consumption can be managed fully decoupled from Stigg subscription management. See direct credit consumption.
- The check-entitlement endpoint continues to return a valid credit balance for customers with no active subscription.
Credit wallet soft limit
- Added:
has_soft_limitfield on check-entitlement responses. When a credit entitlement is configured as a soft limit in the plan or add-on, the check-entitlement endpoint returnshas_access: Trueandhas_soft_limit: Trueeven after the credit balance reaches zero. Hard limit (the default) continues to returnhas_access: Falsewhen the balance is exhausted. Credit-backed features inherit the wallet’s soft-limit so dependent feature reads stay consistent.
Credit usage breakdown by event dimensions
- Added:
group_byarray parameter on the retrieve credit usage endpoint to break down credit consumption by any dimension key attached to reported usage events (e.g.,user,model,region). Results are paginated for performance at high event volumes.
Credit usage date filters
- Added:
start_dateandend_dateparameters on the retrieve credit usage endpoint. Pass specific start and end timestamps to retrieve credit consumption data for an exact time window, in addition to the existing preset period enums. See customer credits.
- Added:
billingCycleAnchorproperty when provisioning and updating subscriptions. AcceptsSubscriptionBillingCycleAnchor.UNCHANGED(default) to keep the existing billing cycle anchor, orSubscriptionBillingCycleAnchor.NOWto reset it to the current timestamp.
- Updated stainless config for the API
- Multiple API updates implemented
- API updates
- Commented out promotional endpoints
- Improved cursor pagination functionality
Features:
- Added customer endpoints
- Support for binary request streaming
- Support for file upload requests
- Environment cleanup improvements
- Don’t send Content-Type header on GET requests
- Python 3.14 compatibility
- Pydantic v1 signature updates
- Stream closure handling
- Nested discriminated union parsing
- Empty metadata handling
- Python 3.14 support added
- Python 3.8 support dropped
- Python 3.13 marked as supported
- Dependency updates and internal codegen improvements
