Creating and Managing Pools

Pools belong to a customer account. To manage them, open a customer account and select the Consumption pools tab.

Show Image

The tab displays:

• Summary cards: The total number of pools on the account, and how many are currently in overage or depleted.
• Pools list: Each pool's name, code, type, a live usage meter, status, reset schedule, and date of last reset.
• Usage report: A per-pool consumption chart scoped to this account. See Usage Reports and Activity.

Managing pools requires the licenses_write permission. Viewing requires licenses_read.

Creating a Pool

Click New pool. The following fields are available:

Field	Notes
Name	Display name, can be edited after creation
Code	Unique identifier within the customer account. Cannot be changed after creation.
Type	Licenses or Product features. Cannot be changed after creation.
Max consumptions	The shared quota for this pool
Allow unlimited consumptions	Removes the cap entirely
Allow overages / Max overages	Additional consumption allowed past the maximum. Set Max overages to 0 for unlimited overages when overages are enabled.
Allow negative consumptions	Enabled by default. The pool balance floors at zero.
Reset consumption / Consumption period	Schedules automatic resets of the pool balance
Default offline checkout	The number of units reserved when a device activates offline without specifying an amount. See Offline Checkouts.

The Pool Detail Page

The balance card at the top shows the live state of the pool:

• The meter divides the used portion into Consumed (settled usage) and Held by offline checkouts (a striped segment representing units reserved by offline devices, which return to the pool when those devices sync).
• Available to spend now = quota − consumed − held.
• When overages are enabled, a divider marks the maximum consumption line and the overage zone is shaded distinctly.

When a pool is depleted, a banner appears explaining that member consumption requests are being rejected with pool_quota_exhausted.

Editing a Pool

Click Edit pool to update the name, quota, overage settings, negative consumption flag, or reset schedule. The Code and Type fields are locked after creation, they appear disabled in the edit form and cannot be changed via the API either.

Resetting a Pool

Reset pool zeroes the pool's balance and every linked member's contribution counter in a single atomic operation. This keeps per-member reporting consistent with the pool total. Activity records are written for the pool and for each affected member.

Pools can also reset automatically on a schedule, configured through the Reset consumption and Consumption period fields.

While a license or feature is linked to a pool, it is excluded from its own scheduled resets , the pool's reset schedule is the only one that applies. Manual resets of individual members are still supported. See Pool Members.

Deleting a Pool

Deleting a pool unlinks all its members without modifying their individual counters. Each member returns to standalone metering, retains its own total_consumptions, and its own configuration takes effect immediately. Only the shared quota is removed.

Before confirming, a dialog shows how many members will be affected.