Credit Limits

Credit Limits let workspace admins cap how many credits each member can spend in a billing cycle. Available on Team and Enterprise plans, this feature gives you control over usage without cutting anyone off unexpectedly — you choose whether hitting the cap stops the agent or just flags it for review.

Setting Up Credit Limits

Navigate to Billing → Credit Limits. You'll need workspace owner or admin access to manage this page.

Set the workspace default:

1. Under Default Credit Limit, enter a number to apply a per-user cap for the billing cycle, or leave it set to Unlimited to impose no default restriction.
2. Choose an enforcement mode:
   • Hard — the agent stops when a member reaches their limit. They'll see an error and a prompt to request more.
   • Soft — the agent continues past the limit, but usage is flagged and visible to you in the usage table.
3. Click Save to apply the default to all members who do not have a per-user override.

Note: Limits reset at the start of each billing cycle (calendar month). Usage during the current cycle does not carry over.

Per-User Overrides

If a specific member needs a different limit from the workspace default — more headroom for a power user, a tighter cap for someone onboarding — you can set an individual override.

1. In the member usage table at Billing → Credit Limits, find the member you want to adjust.
2. Click Set Override (or Edit Override if one already exists) to open the override panel.
3. Enter the credit limit you want to apply to that member and click Save.

The member's Effective Limit column will update immediately to reflect their override.

To remove an override and revert a member to the workspace default, open their override panel and click Remove Override.

Note: Per-user overrides take precedence over the workspace default. Changing the workspace default later will not affect members with active overrides.

Per-Project Limits

In addition to per-user limits, you can set credit limits at the project level. This caps how many credits a specific project can consume in a billing period, regardless of which members are working in it.

To create a per-project limit:

1. Go to Billing → Credit Limits.
2. Click Create Limit.
3. Use the searchable project selector to find and select the project you want to cap.
4. Enter the credit limit amount and click Save.

The per-project limit table only shows projects where a limit has been configured. Projects without a limit set do not appear in the table.

If a project hits its credit limit, the agent stops and an error appears for the member working in that project. To adjust or remove a project limit, find the project in the table and update or delete its entry.

Monitoring Usage

The usage table at Billing → Credit Limits shows every member in the workspace with:

• Effective Limit — their active cap (workspace default or per-user override)
• Current Cycle Usage — credits spent so far this billing period
• Progress bar — a visual indicator of how close they are to their limit

Above the table, the Usage Summary shows the billing period start and end dates, plus a count of members currently at 80% or more of their limit. This is the fastest way to spot who might need a limit adjustment before they hit their cap.

Handling Limit Increase Requests

When a member hits their hard limit, they can submit a request for more credits directly from the error they see. You'll receive an email notification when a request comes in.

To review requests:

1. Go to Billing → Credit Limits.
2. Open the pending request from the member.
3. Review their requested limit and the reason they provided.
4. Click Approve to set a per-user override at the requested amount, or Deny to decline the request.

Approving a request automatically creates a per-user override for that member. They do not need to do anything else — their new limit takes effect immediately.

What Members See

Members on Team and Enterprise workspaces see credit usage information in the chat footer as they approach or exceed their limit.

Approaching the limit (75% used):

An amber banner appears at the bottom of the chat. This is informational — the agent keeps running normally. The banner can be dismissed and will not reappear in the same session.

Soft limit exceeded:

An orange banner appears. Under soft enforcement, the agent continues running.

Hard limit reached:

The agent stops. An error bar appears with the message: "You've reached your credit limit for this billing period. Contact your workspace admin." This error appears whether a per-user limit or a per-project limit was reached. A Request Increase button appears in the error bar.

To submit a request, the member clicks Request Increase, enters the credit amount they need and a brief reason, and submits.

Note: Credit Limits are only available on Team and Enterprise plans.

Troubleshooting

The Credit Limits page is not visible in my Settings.

This page is only accessible to workspace owners and admins.

A member says they hit their hard limit but I do not see a request.

The Request Increase button is optional. Check the usage table to confirm their current usage, and set a per-user override directly if you want to give them more headroom.

I changed the workspace default but one member's effective limit did not change.

That member likely has a per-user override in place. Open their row in the usage table to review or remove the override.

A member's usage shows 0 but they've been active this cycle.

Credit usage syncs periodically. Refresh the page and check again.

Something else is not working as expected.

Reach out to help@obvious.ai with your workspace name and a description of what you're seeing.