For the complete documentation index, see llms.txt. This page is also available as Markdown.
New

Credits & Tokens

Track credit consumption, set usage limits, and receive spend alerts.

Track account credit consumption and control spending from Billing. Credit Usage shows consumption and history. Usage Limits caps spending and sends threshold alerts.

The Credit Usage screen, showing available and used credits with a usage trend chart
Credit Usage, showing available/used credits and consumption trends.

Track spending

Review available and used credits, trends, resource usage, and the full transaction ledger.

Control spending

Create hard limits before requests consume credits. Add alerts for administrators before usage reaches a threshold.

At a glance

Area
Use it to
Start here

Credit Usage

Review consumption, trends, and transaction history

Usage Limits

Set hard caps and alert thresholds

Everything the platform does consumes credits. Usage limits are checked before consumption. Requests exceeding a limit are rejected.

Credit Usage

Credit Usage shows your credit consumption and transaction history. Open Billing → Credit Usage.

You can narrow by workspace and date range. The page shows your Available credits and Used credits for the selected period, with Usage Trends plotting consumption over time.

Resource Usage breaks spend down by what consumed it, across four tabs — Apps, Agents, Models, and Features. Each row lists a resource's Name, Credits Used, and Last Used. Resource usage can lag live activity by up to an hour.

Two shortcuts sit at the top of the page: Set usage limit jumps to Usage Limits, and View Ledger opens your full credit history.

Credit history

View Ledger opens the Credit History dialog — every credit and debit transaction on your account:

Column
What it shows

Operation Type

Debit (credits spent) or Credit (credits added).

Additional Details

What the transaction was for (for example, Action Deduction, Credits Addition).

Credit Change

The amount added or deducted.

Balance Credit

The running balance after the transaction.

Timestamp

When it happened.

The Credit History dialog, listing debit and credit transactions with running balance
The Credit History dialog, opened from View Ledger.

Usage Limits

Usage Limits lets you cap credit consumption and get alerted before you reach a threshold. Open Billing → Usage Limits. The page has two sections — limits and alerts — and a How it works note.

The Usage Limits screen, listing configured limits and alerts
Usage Limits, with configured limits and alerts.

Usage Limits are hard caps: requests that would exceed a limit are rejected. Each limit shows its period, its cap, and its type — for example, a Monthly limit of 80,000 Credits as a Hard Limit that resets on the 1st of every month. Use + Add Limit to create one, and the per-row menu to edit or remove it.

Usage Alerts notify administrators before usage reaches a threshold. Use + Add Alerts to create one.

How it works: All usage limits are evaluated before credit consumption. If any limit would be exceeded, the request is rejected. Usage alerts send emails once per period when their thresholds are crossed.

Add an alert

+ Add Alerts opens the Add Alert dialog:

  • Duration — required. The period the alert evaluates over (for example, Daily).

  • Metric Type — required. Absolute Credits alerts on a raw credit count; Percentage of Limit alerts on a share of a configured limit.

  • Credit Limit / threshold — required. The value to alert at. The field matches the metric type — a credit count for Absolute Credits, a percentage for Percentage of Limit.

The Add Alert dialog, with Duration, Metric Type, and Credit Limit fields
The Add Alert dialog.
The Metric Type dropdown in the Add Alert dialog, showing Absolute Credits and Percentage of Limit options
Choosing between Absolute Credits and Percentage of Limit as the alert metric.
Control CenterLogs & DataObservabilityAccount Settings

Last updated