{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Studio Billing","projectTitle":"Frontline Documentation"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"studio-billing","__idx":0},"children":["Studio Billing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Studio Billing"]}," is the account-level product: credits, agents, workflows, flows, sequences, users, and knowledge bases against the plan limits. This is separate from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/max/billing"},"children":["Max Billing"]},", which is seats and capability licenses for the personal assistant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Buying, changing, or cancelling the Studio plan is done in the app. The Public API reads the current plan, usage, and credit consumption history."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /billing"]}," accepts an account API key. Usage (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /billing/usage"]},") requires a USER API key."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-usage-reports","__idx":1},"children":["What usage reports"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Credits used vs the monthly limit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Counts of agents, workflows, flows, sequences, users, and knowledge bases against plan limits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Current plan, subscription details, and any scheduled plan change (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usage.sequences"]}," is the count of currently ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LIVE"]}," sequences; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limits.sequencesLimit"]}," is the max allowed by the plan. Draft sequences do not count — only publishing is gated (a 402 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upgrade_required"]}," on publish when you are over the limit)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credit history is one entry per day per AI model: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modelName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalCredits"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messageCount"]},". Filter with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_date"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," (ISO dates)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operations","__idx":2},"children":["Operations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Verb"},"children":["Verb"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/billing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plan name, credits, renewal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/billing/usage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Studio usage vs limits (USER key)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/billing/credits/history"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Daily credit consumption by model"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full list in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/reference/openapi"},"children":["API Reference"]}]}," under the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Billing"]}," tag."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cli","__idx":3},"children":["CLI"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"frontline billing get --pretty\nfrontline billing studio usage --pretty\nfrontline billing studio credits --start-date 2026-08-01 --end-date 2026-08-31 --table\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Studio Billing","id":"studio-billing","depth":1},{"value":"What usage reports","id":"what-usage-reports","depth":2},{"value":"Operations","id":"operations","depth":2},{"value":"CLI","id":"cli","depth":2}],"frontmatter":{"seo":{"title":"Studio Billing"}},"lastModified":"2026-10-02T13:31:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/admin/studio-billing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}