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:
hasSoftLimitfield on check-entitlement responses. When a credit entitlement is configured as a soft limit in the plan or add-on, the check-entitlement endpoint returnshasAccess: trueandhasSoftLimit: trueeven after the credit balance reaches zero. Hard limit (the default) continues to returnhasAccess: 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:
groupByarray 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:
startDateandendDateparameters 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
- API updates delivered in this release
- Manual updates to the API
Features:
- Added customer endpoints
- Exception handling for retryable scenarios
- Improved cursor-based pagination
- HTTP configuration options and dispatcher customization
- ProGuard and R8 compatibility enhancements
- Multi-value header serialization fixes
- Timezone preservation in date-time parsing
- CI/CD pipeline improvements
- Documentation updates
- Extensive API endpoint coverage
