Skip to content

Document API key spend limits and key names on the billing page #1416

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Chadha93 merged 4 commits into from
Sep 15, 2026
Merged

Document API key spend limits and key names on the billing page #1416

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
26943d6
Document API key spend limits and key names on the billing page
claude Sep 15, 2026
f1cc780
Soften the search carve-out in the spend limit note
claude Sep 15, 2026
91a769c
Drop the search note from the spend limit section
claude Sep 15, 2026
3a444f0
Update billing.mdx
Chadha93 Sep 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions billing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,19 @@ For example, a limit of 25 USD allows five increments each month. A limit of 22

Credits that you buy manually do not count toward this limit.

## API key spend limits {#api-key-spend-limits}

A spend limit caps the credits that one API key can use. The cap applies to that key alone, whatever your team balance is. Use it to stop one key from spending the whole team balance.

You can also rename any API key. This includes the key named **Default** that Firecrawl creates with your team.

The key owner or a team admin can do both. Open the [API keys page](https://www.firecrawl.dev/app/api-keys) in the dashboard, then open the menu on the key.

- Click **Rename** to change the **Key Name**.
- Click **Set limit** to open **Set a spend limit**. Enter a **Credit limit**, pick **per day**, **per week** or **per month**, then click **Save**.

A limit is a number of credits, not an amount of money. A limit of `1` means one credit per period. Click **Remove limit** to clear the limit.

## Upgrading and Downgrading

- **Upgrades** take effect immediately. You are charged the full new-plan price today (no proration), and your billing cycle resets. Your next renewal is one month or one year from the upgrade date. Any unused credits from your previous plan carry over, and your new credit allotment and concurrency limits apply right away.
Expand Down
Loading