How do I manage AI usage limits across my tenants?

Why per-tenant AI limits exist, what the defaults are, how to change them, and what they don't cover.

If you have multiple tenants under your account, Coassemble applies a per-tenant limit on AI feature usage. You set and change those limits through the API, and every tenant draws from your account's shared allowance.

Why tenant limits exist

Tenants under your account share your total monthly allowance for narration tokens and AI image generation events. The per-tenant limit exists so you can see and control how that shared pool is distributed, rather than having one tenant quietly consume most of it.

Your account's allowance and each tenant's limit are tracked separately, and both reset at the start of the next calendar month.

Default tenant limits

Every new tenant starts with:

• 250,000 narration tokens per month
• 150 AI image generation events per month

Setting and changing tenant limits

You can change a tenant's limit via the Coassemble API:

• Set a different numeric limit.
• Set the limit to "unlimited" if you want a specific tenant to draw freely from your account allowance. This doesn't add to the pool, it just removes that tenant's own ceiling.

For the API endpoint and request shape, see the developer documentation.

What tenant limits don't cover

• Identified Recipients (IR) and Anonymous Recipients (AR) are not limited at the tenant level. They are tracked and enforced at the account level only.
• Top-ups don't apply at the tenant level. If a tenant is running low mid-month, raise its limit, or set it to unlimited.
• Tenants can't change their own limits. Only the parent account can, via API.

Seeing per-tenant usage

The Per-Tenant Usage Reporting API exposes consumption breakdowns by tenant for any time window, so you can build dashboards or alerts on top of the data. See the developer documentation for the endpoint shape.

This is the reliable way to keep an eye on distribution across your tenants, and it is worth wiring up an alert on it rather than waiting to discover a heavy tenant at the end of the month.

Frequently asked questions

Can I bulk-set limits for all my tenants at once?

There's no bulk-set helper. You can call the API for each tenant.

Are tenant limits visible to the tenant's admin?

No. Limit visibility is at the parent account level.

When do the counts reset?

At the start of each calendar month, for both your account allowance and every tenant limit.

What happens when the account allowance runs out?

Nothing switches off. Narration tokens and image generation events are soft capped, so going past your account allowance starts a conversation with us rather than a block. We'll get in touch before anything changes, so there are no surprise cut-offs and no automatic overage billing. Raising a tenant's limit doesn't change the size of the account pool, because tenant limits divide it rather than add to it.