Skip to content
All changes

Require a plan before a workspace is used

The same New workspaces setting can now require every workspace to choose a plan, free or paid, before it records usage or spends credits, and it tells your app and AI agents how to choose one.

Added
4
  • BillingSettings > Organization > New workspaces has a third choice: require a plan before a workspace is used. Until a plan is chosen, recording usage and spending credits are refused with the code PLAN_REQUIRED. Reading, members, settings and billing stay open, so a plan can always be chosen. It applies to workspaces that have no plan today too.
  • APIThe refusal names the routes that end it: the one that lists the plans, the one that selects a free plan and the one that starts a checkout. A workspace's subscription read says planRequired before anything is refused.
  • SDKWith the next SDK release, your app opens its plan picker by itself for a workspace with no plan and keeps it open until a plan is chosen, for anyone who may manage that workspace's billing. An app that shows its own plans can turn this off.
  • AI agentsWith the next SDK release, an agent on your app's MCP server is told it needs a plan, and which tools choose one, and can put the workspace on your free plan itself with select_free_plan. A paid plan still goes to a person for the card.

Use what shipped this week

Everything in this release is already in the console and the SDK.

Free plan7-day free trial on paid plansNo credit card required