The sidebar labels inside this family are the literal calls you make over HTTP. Descriptions stay in the body so the navigation stays sharp and scannable.
Operations in this family
GET /.well-known/oauth-authorization-server
Return or proxy OAuth authorization server metadata for the configured WorkOS tenant
GET /.well-known/oauth-protected-resource
Return OAuth protected resource metadata for hosted MCP and API clients
POST /mcp
Hosted MCP transport endpoint
GET /v1/api_keys
List API keys for the current organization
POST /v1/api_keys
Create a new API key for the current organization and reveal its secret exactly once
GET /v1/billing
Return the current organization’s billing snapshot, including pricing posture, budget controls, and settlement provider state
PUT /v1/billing/budget
Update organization-level spend caps, soft caps, and approval thresholds for PAYG usage
POST /v1/billing/checkout
Create a Stripe Checkout session for a self-serve Personal or Team SEC API plan
GET /v1/billing/credits
Return the current organization’s prepaid credit balance, auto-top-up settings, lifetime totals, and low-balance status
PUT /v1/billing/credits/auto-topup
Enable or disable automatic prepaid-credit top-ups and set the low-balance threshold and refill amount
POST /v1/billing/credits/refund
Refund the unspent credits of a prepaid top-up to the original payment method, within the refund window (platform fees non-refundable)
POST /v1/billing/credits/topup
Create a Stripe PaymentIntent to purchase prepaid credits, returning the client secret and the discount/fee charge breakdown
GET /v1/billing/credits/transactions
List the current organization’s prepaid credit ledger entries (top-ups, debits, refunds, grants, adjustments), newest first
POST /v1/billing/grant/reset
Re-grant the one-time free starter allowance (resets free-grant usage), rate-limited to once per rolling 30 days per organization
POST /v1/billing/payg/enable
Enable pay-as-you-go in one flow: save a card, make an initial credit top-up, and optionally turn on auto-top-up (returns a PaymentIntent client secret)
GET /v1/billing/payment-methods
List the current organization’s saved payment methods, primary first
PUT /v1/billing/payment-methods/{id}
Set a saved payment method as primary and/or change its auto-top-up fallback priority
DELETE /v1/billing/payment-methods/{id}
Remove a saved payment method from the current organization
POST /v1/billing/payment-methods/setup-intent
Create a Stripe SetupIntent to save a payment method off-session for top-ups and auto-top-up (max 3 per organization)
POST /v1/billing/portal
Create a Stripe Billing Portal session for the current organization
POST /v1/billing/quote
Quote a billable workflow or meter class against the current billing plan and budget gates
GET /v1/billing/rates
Return the public pricing catalog, starter grant metadata, plan metadata, and meter-family launch rates
GET /v1/billing/stripe-config
Return the current organization’s Stripe publishable-key configuration for browser payment setup
POST /v1/billing/webhooks/stripe
Receive and process signed Stripe subscription lifecycle webhooks
GET /v1/limits
Return the current organization’s effective plan, billing state, and route quota windows
GET /v1/me
Return the current authenticated principal and organization context
GET /v1/org
Return the current organization profile

