Skip to main content
Mintlify’s AI features run on credits. Your organization has one monthly credit balance, shared by every deployment and everyone on your team. Manage it on the Usage page in your dashboard.

Your shared balance

Your balance comes from three places:
  • Your plans. Every Pro plan in your organization contributes 10,000 credits per month. An organization with two Pro deployments starts each month with 20,000 credits.
  • Add-ons. Buy an add-on when you need more than your plans include. An add-on is one purchase for the organization rather than one per deployment, and any deployment can spend it.
  • Rollover. Unused credits carry into the next month and join the same balance.
Every deployment and every team member spends from that shared balance. The Usage page shows the organization-wide balance, with per-deployment usage broken out below it. Individual deployments have their own overage settings, so you can configure different overage behaviors for each one.
Credits were previously tracked per deployment. They now pool at the organization level.

What uses credits

Your credit balance powers the assistant, agent, and automations. The assistant uses credits for each interaction with a user. The agent uses credits for each run you invoke. Automations use credits each time they run, whether you run them on a schedule, on a trigger, or manually. Runs use different amounts of credits depending on the task size and context used. The cost depends on how much content the agent reads, how many files it changes, and how long the run takes.

Plan availability

Credits are available on the Pro and Enterprise plans. The Starter plan does not include AI features, and you cannot purchase credits on it. To use the assistant, agent, or automations, upgrade to Pro or Enterprise.
Customers on legacy credit plans keep their existing credit packs and pricing. The add-ons below apply to the Pro plan.

Credit add-ons

Each add-on adds credits to your organization’s monthly balance on top of what your plans include. A single Pro deployment with the 40,000-credit add-on has 50,000 credits per month. Larger add-ons cost less per credit. The 90,000-credit add-on costs about 8% less per credit than the 15,000-credit one. All three add-ons cost less per credit than the $0.01 overage rate. Add or change an add-on in the Credit packages section of the Usage page. Changes take effect immediately, and Mintlify prorates the charges to your current billing cycle. The 90,000-credit add-on is the largest you can buy yourself. For more than that, contact sales to discuss a custom credit package, available on Enterprise plans only. For the most current pricing, see the pricing page.

Spending controls

Overages

Overages let a deployment keep running after your organization exhausts its monthly credits, at $0.01 per additional credit. They are off by default. Enable them in the Spending controls section of the Usage page. You configure overages per deployment, so when the shared balance runs out, each deployment’s own setting decides what happens to it. A deployment with overages off loses its credit-powered features until the balance resets. Every add-on costs less per credit than the $0.01 overage rate. Use overages to absorb an occasional busy month. If your organization exceeds its balance consistently, buy an add-on or move to a larger one instead.

Usage alerts

Set usage alerts in the Spending controls section of the Usage page to receive an email when your organization reaches a given percentage of its balance. Alerts cover the organization as a whole rather than a single deployment.

Rollovers

Up to 50% of unused credits carry forward to the next month, so the most your organization can have available in any month is 1.5 times its monthly balance. Rollovers reset when you change add-ons.

Estimate your usage

Credit costs vary by task. View the Usage page in your dashboard to see how your deployment uses credits. The Activity log section lists the credits consumed by each event. Multiply the cost of a typical event by your expected monthly volume to project what your organization needs.

Export usage activity

Export your usage activity log to CSV for deeper analysis, reporting, or record-keeping.
  1. Navigate to the Usage page in your dashboard.
  2. Optionally, adjust the date range in the toolbar to change the period the export covers.
  3. In the Activity log section, click Export to CSV.
  4. Mintlify emails you a download link when the export is ready. The link expires after 72 hours.
The exported CSV includes the date, product, and credits consumed for each event in the selected range.

Reduce credit usage

Run automations on a schedule

SEO audits, writing style checks, and broken link detection don’t need to run on every code change. A daily or weekly schedule lowers credit consumption because the agent batches work across multiple changes in a single run. The tradeoff is a delay between when content changes and when the automation acts on it.

Bring your own model

On Enterprise plans, you can supply your own LLM provider API key and choose the model behind the assistant, agent, and automations. Mintlify meters usage at a reduced credit rate, and your provider bills you directly for inference. You configure models per deployment, not for an entire organization. See Bring your own model for more information.

Find what’s consuming your credits

The Usage page breaks usage down by feature category. If one automation costs more than you expect, review its trigger frequency and any custom instructions that widen its scope.