Appearance
Usage providers
Where the bills come from. This is where an admin connects each AI provider's billing API so Flowstate can pull authoritative usage and spend, distinct from the device-side telemetry the Flowstate Agent collects.
The page lives at Settings → AI → Usage Providers. Admin-only — the underlying mutation requires SETTINGS_INTEGRATIONS_UPDATE.
Why both telemetry and billing pulls
Telemetry from the agent gives you per-session detail with prompt-level granularity. Billing pulls give you the provider's authoritative number — the one you actually pay against. They rarely match exactly. The Spend reconciliation screen is what bridges them.
Without a billing pull, you can still see telemetry-side spend in Attribution, but the reconciliation surface won't have an invoice side to match against.
Supported providers
| Provider | Credentials needed |
|---|---|
| Cursor | Team API key from Settings → Team → API Keys |
| OpenAI Codex / ChatGPT | Admin API key from platform.openai.com/organization/admin-keys |
| Anthropic / Claude Code | Admin key starting with sk-ant-admin... |
| Gemini | (configuration-free) |
| Windsurf | (configuration-free) |
| GitHub Copilot | Personal Access Token with manage_billing:copilot and read:org scopes, plus the GitHub organisation slug |
| Demo | None — generates synthetic data for testing |
The Demo provider is useful for evaluating Flowstate before you've wired any real provider. It seeds plausible usage and telemetry so the dashboards have something to render. Don't enable it in production — its data is clearly labelled but it pollutes the org's reconciliation queue.
Connecting a provider
- Click Add Provider in the top right.
- Pick the provider from the dropdown.
- Fill in the credential fields the form prompts for (varies by provider — see the table above).
- Click Save.
Flowstate validates the credentials by attempting an immediate sync of the last 24 hours. The dialog closes on success and the provider appears in the table with status Active. On failure, the toast surfaces the provider's error message — usually a permission scope issue or a typo'd key.
Test connection
The … menu on each row carries a Test action. It triggers a single-day sync and reports success or the actual error message in a toast. Use this after rotating a credential or when Providers inventory flags a monitoring gap.
Removing a provider
The … menu also carries Remove. This deletes the integration; existing historical data is retained. The provider's catalogue row in Providers inventory drops to DISCONNECTED if no agent traffic is replacing it.
WARNING
Removing a provider stops the billing pull. Spend reconciliation for periods after the removal will show all observed spend as residual variance until you reconnect (or write off the period).
What this isn't
This page is not the provider catalogue. The catalogue is read-only and discovery-driven — it lists every AI tool the org talks to, including ones Flowstate has never been given billing credentials for. This page is the credential surface specifically.
It's also not where you manage the agent's telemetry keys — those identify on-device traffic and are managed separately under Settings → AI → Telemetry Keys.