Skip to main content
2026-08-10
  • ⚠️ Removed: billing_model and billing_cadence fields from the overage pricing model.
2026-08-05
  • Added: display_name field on entities, description field on entity types.
2026-08-05
  • Added: event_count field on credit usage response types.
2026-07-28
Contracts
  • Added: a contracts resource and retrieve_contracts method on customers. See contracts.
2026-07-26
  • Added: credit_entitlement field on addon and plan update params.
2026-07-21
  • Added: sync_states field on credit grant responses.
2026-07-21
  • Added: event_type parameter on the credits list_ledger method.
2026-07-18
  • ⚠️ Moved: customers.retrieve_governance from v1.events.beta to v1_beta.
2026-07-14
  • Added: STRIPE_INVOICING to the vendor identifier enum on customers.
2026-07-14
  • Added: events.estimate and usage.estimate methods on customers.
2026-07-12
  • Added: consumed field on consumption_consume and usage_report responses.
2026-07-08
  • Added: idempotency_key parameter on the usage report method.
2026-07-05
  • ⚠️ Renamed: capability_id to currency_id, and added feature_id, on the assignments list.
2026-07-05
  • ⚠️ Renamed: type_ref_id/type_id to entity_type_id in entities and governance responses.
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_limit field on check-entitlement responses. When a credit entitlement is configured as a soft limit in the plan or add-on, the check-entitlement endpoint returns has_access: True and has_soft_limit: True even after the credit balance reaches zero. Hard limit (the default) continues to return has_access: False when 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_by array 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_date and end_date parameters 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: billingCycleAnchor property when provisioning and updating subscriptions. Accepts SubscriptionBillingCycleAnchor.UNCHANGED (default) to keep the existing billing cycle anchor, or SubscriptionBillingCycleAnchor.NOW to reset it to the current timestamp.
2026-01-29
  • Updated stainless config for the API
2026-01-28
  • Multiple API updates implemented
2026-01-27
  • API updates
  • Commented out promotional endpoints
  • Improved cursor pagination functionality
2026-01-26
Features:
  • Added customer endpoints
  • Support for binary request streaming
  • Support for file upload requests
  • Environment cleanup improvements
Bug Fixes:
  • 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
Chores:
  • Python 3.14 support added
  • Python 3.8 support dropped
  • Python 3.13 marked as supported
  • Dependency updates and internal codegen improvements