Open the Stripe Billing Portal

POST 
/api/billing/portal

Create a hosted Stripe Billing Portal session and return its URL so the tenant can manage its payment method, view invoices, or cancel. Admin only.

Requires the live Stripe provider AND an existing Stripe customer (a tenant that has been through paid checkout). Returns 409 when billing is not Stripe-backed yet (free tenant / fake provider) — there is nothing to manage.

Responses

200

A hosted Billing Portal URL to redirect the browser to.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

409

No Stripe-backed customer to manage (free tenant or non-Stripe provider).