Billing and limits

Understand plan state, usage limits, checkout, billing portal, and PLAN_LIMIT_REACHED errors.

Owners and admins can manage billing.

Endpoints

Method	Endpoint	Description
GET	/api/orgs/{id}/billing	Get plan, status, usage, limits, and subscription summary
POST	/api/orgs/{id}/billing/checkout	Create Stripe Checkout Session
POST	/api/orgs/{id}/billing/portal	Create Stripe Billing Portal Session

Checkout

{
  "plan": "starter"
}

or:

{
  "plan": "team"
}

Plan limit errors

Creation endpoints can return:

{
  "error": "Plan limit reached",
  "code": "PLAN_LIMIT_REACHED",
  "resource": "activeProjects",
  "plan": "free",
  "limit": 2,
  "usage": 2
}

Plan-limited resources include:

• Humans
• Agents/integrations
• Active projects
• Active issues

Local development

The app uses Stripe environment variables for billing:

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
STRIPE_PRICE_STARTER_MONTHLY
STRIPE_PRICE_TEAM_MONTHLY
NEXT_PUBLIC_APP_URL