> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ruby

<Update label="0.1.0-beta.35" description="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](/documentation/modeling-your-pricing-in-stigg/credits/credits-core-concepts#direct-credit-consumption).
  * The check-entitlement endpoint continues to return a valid credit balance for customers with no active subscription.
</Update>

<Update label="0.1.0-beta.30" description="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.
</Update>

<Update label="0.1.0-beta.15" description="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.
</Update>

<Update label="0.1.0-alpha.29" description="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](/documentation/modeling-your-pricing-in-stigg/credits/customer-credits).
</Update>

<Update label="0.1.0-alpha.4" description="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.
</Update>

<Update label="0.1.0-alpha.3" description="2026-01-29">
  * Updated stainless config
</Update>

<Update label="0.1.0-alpha.2" description="2026-01-28">
  * Multiple API updates
  * Commented out promotional endpoints
  * Improved cursor pagination
</Update>

<Update label="0.1.0-alpha.1" description="2026-01-26">
  **Features:**

  * Added customer endpoints
  * Multiple API updates and manual refinements

  **Bug Fixes:**

  * Better thread safety via early initializing SSL store during HTTP client creation
  * Calling `break` out of streams is now instantaneous
  * Fixed issue where JSON parse errors when receiving HTTP 204 with no body
  * Ensured Sorbet tests run serially

  **Chores:**

  * Dependency updates and Sorbet type configuration
  * Base64 gem requirement
  * Ruby 4 compatibility adjustments
  * Documentation and configuration updates
</Update>