Provider Keys is an account-admin-only feature. You must be an account admin
to connect, replace, or remove a key, whether from the dashboard or through
firectl.How it works
- Providers: you can add a key for Anthropic and OpenAI.
- One key per provider: each provider connects a single key. Adding a new key for a provider replaces the old one.
Add a key from the dashboard
The simplest way to add a key is in the dashboard. No terminal needed.1
Open Provider Keys
Open Settings and go to Provider Keys.
2
Connect a provider
Find the provider you want (Anthropic or OpenAI) and click Connect.
3
Paste your key
Paste your key and click Connect. You will see a confirmation once it is saved.
Manage a key later
Open the menu on any connected provider to:- Replace: swap in a new key value for that provider.
- Remove: remove the key.
Using firectl
Every action is also available through firectl if you prefer the terminal. Stored keys live under firectl provider-key, and routing (which key is live) lives under firectl provider-key-binding. firectl firerouter-provider-key works as an alias.
The CLI also covers one thing the dashboard does not: stopping a key without deleting it (provider-key-binding unbind). This keeps the key stored so you can start using it again later, without re-uploading.
Add or replace a key
Upload stores a key, it does not turn it on. Point FireRouter at it withbind. --provider-type is required and accepts anthropic or openai.
The quickest way is --api-key, read from an environment variable so the value stays out of your shell history:
--from-file. The file should hold only the raw key, with no JSON, quotes, trailing newline, or other surrounding text:
On a shared or multi-user machine, prefer
--from-file. The shell expands
$ANTHROPIC_KEY before firectl starts, so --api-key keeps the key out of
your shell history but still exposes it in the process list (ps) while the
command runs. --from-file passes only the path.upload and bind again for the same provider replaces the value in place.
Check status
provider-key list shows the key ID, provider, masked preview, and display name. provider-key-binding list / get is where you see whether a provider is connected and which key_id is in use.
Delete a key
Use thekey_id from upload or provider-key list. If that key is the live one for the provider, unbind it first. Unbind alone only stops FireRouter from using it; the key stays stored until you delete it.
Additional info
- An explicitly provided key on a request takes precedence. If a request already includes a provider key, that key is used and the stored one is skipped.
- Changes are not instant. After you connect, replace, or remove a key, allow up to about a minute before the change applies to requests. The provider may briefly show Connecting or Disconnecting while it takes effect.
- Your key stays private. The full key is stored securely and never returned. The dashboard and API only show the provider, state, masked preview, and dates.