Studio Billing is the account-level product: credits, agents, workflows, flows, sequences, users, and knowledge bases against the plan limits. This is separate from Max Billing, which is seats and capability licenses for the personal assistant.
Buying, changing, or cancelling the Studio plan is done in the app. The Public API reads the current plan, usage, and credit consumption history.
GET /billing accepts an account API key. Usage (GET /billing/usage) requires a USER API key.
- Credits used vs the monthly limit.
- Counts of agents, workflows, flows, sequences, users, and knowledge bases against plan limits.
- Current plan, subscription details, and any scheduled plan change (
next).
usage.sequences is the count of currently LIVE sequences; limits.sequencesLimit is the max allowed by the plan. Draft sequences do not count — only publishing is gated (a 402 upgrade_required on publish when you are over the limit).
Credit history is one entry per day per AI model: date, model, modelName, totalCredits, messageCount. Filter with start_date and end_date (ISO dates).
| Verb | Path | Purpose |
|---|---|---|
GET | /public/v1/billing | Plan name, credits, renewal |
GET | /public/v1/billing/usage | Studio usage vs limits (USER key) |
GET | /public/v1/billing/credits/history | Daily credit consumption by model |
Full list in the API Reference under the Billing tag.
frontline billing get --pretty
frontline billing studio usage --pretty
frontline billing studio credits --start-date 2026-08-01 --end-date 2026-08-31 --table