2026-08-10
- Removed:
billing_modelandbilling_cadencefields from addon and plan overage pricing objects. Update any code that reads these fields directly.
2026-08-05
Entity display names and descriptions
- Added:
display_nameparameter when creating or updating entities, anddescriptionparameter when creating or updating entity types, via the beta governance API. Use these to attach human-readable labels to entities and document what an entity type represents.
2026-08-05
- Added:
event_countfield on each series returned by the retrieve credit usage endpoint, reporting the number of distinct usage events that consumed credits in that series.
2026-07-28
Contracts
- Added: a
contractsresource to create a contract for a customer together with all of its subscriptions in a single atomic operation. Each subscription entry is either a new subscription to create or a reference to an existing custom subscription; billing setup can be skipped so the contract only provisions access. See contracts.
2026-07-26
- Added:
credit_entitlementparameter on addon and plan overage pricing config, to grant a credit entitlement automatically when a credit overage targets a currency not yet granted on the plan.
2026-07-21
- Added:
sync_statesfield on credit grant responses, reporting the synchronization state of the grant with connected external systems.
2026-07-21
- Added:
event_typefilter parameter on the list credit ledger endpoint, to filter ledger entries by one or more comma-separated event types.
2026-07-14
- Added:
STRIPE_INVOICINGvendor identifier, for customers using Stripe Invoicing as their billing connection.
2026-07-14
Cost estimation endpoints
- Added:
estimateendpoints on events and usage reporting, to preview the credits a usage event or usage report would consume before sending it, without persisting any data or affecting balances.
2026-07-12
- Added:
consumedfield on the credit portion of the usage report response — the credits deducted by that specific call (0for idempotent duplicates), as distinct fromcurrent_usage, the wallet’s running total.
2026-07-08
- Added:
idempotency_keyparameter on the usage report endpoint, to safely retry usage reports without double-counting.
2026-07-05
- Added:
feature_idfield on customer capability assignments, present for feature capabilities. - Changed: renamed
capability_idtocurrency_idon customer capability assignments, present for credit capabilities.
2026-07-05
- Fixed: renamed entity type fields to
entity_type_idconsistently across the beta governance, entities, and assignments endpoints.
2026-07-08
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.
2026-06-25
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.
2026-06-01
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.
2026-05-10
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.
2026-03-19
- 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.
2026-01-29
- Updated stainless config
2026-01-28
- Multiple API updates
- Commented out promotional endpoints
- Improved cursor pagination
2026-01-26
Features:
- Added customer endpoints
- Multiple API updates and manual refinements
- Better thread safety via early initializing SSL store during HTTP client creation
- Calling
breakout of streams is now instantaneous - Fixed issue where JSON parse errors when receiving HTTP 204 with no body
- Ensured Sorbet tests run serially
- Dependency updates and Sorbet type configuration
- Base64 gem requirement
- Ruby 4 compatibility adjustments
- Documentation and configuration updates