How-to guides
Provider accounts
Provider accounts are the upstream identities IO Gateway uses when routing model requests. Add at least one healthy account before exposing an API key to clients.
Before you start
- Credential storage Confirm
auth_dirpoints to the directory where provider credentials should live. - Provider support Use provider-specific account flows for Claude, Gemini, Codex, Qwen, GLM, Grok, Copilot, or other enabled providers.
Add or maintain an account
- 1Open the dashboard provider section.
Select the provider that should receive traffic.
- 2Add the credential.
Use the provider-specific OAuth or API-key flow.
- 3Test the account.
Run a short Test API prompt to prove the account can serve traffic.
- 4Watch state changes.
Disabled, failed, cooling-down, and quota-exhausted accounts are skipped by routing.
Account operations
| Operation | Use when |
|---|---|
| Disable | Remove an account from routing without deleting its credential. |
| Refresh | Reload health, quota, or provider-side state. |
| Re-authenticate | Repair expired OAuth or invalid provider credentials. |
| Delete | Remove the account and prune routing state such as priority membership. |
Verify routing
Use usage history to confirm that traffic reaches the expected account. For deliberate account draining, enable priority routing.