Sign in

v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Organization Billing

Subscribe To Plan

Subscribe to a paid plan via Stripe Checkout.

Creates a Stripe Checkout Session in subscription mode. After payment, the organization's account_type is updated via webhook.

If the organization already has an active subscription, the plan is changed inline (upgrade/downgrade with proration) instead of creating a new checkout session.

Available Plans (tier minimum is a billing floor; usage above it bills automatically):

  • managed_build: Managed Mixpeek Build — $25/mo min, 100K objects/mo
  • managed_scale: Managed Mixpeek Scale — $250/mo min, 1M objects/mo
  • mvs_build: MVS Standalone Build — $25/mo min, 1M vectors
  • mvs_scale: MVS Standalone Scale — $250/mo min, 25M vectors

Discounts: each non-empty onboarding_answers field takes $5 off the first invoice (max $10). An explicit promo_code is validated and pre-applied; when both are sent the promo takes checkout's single discount slot and the onboarding credit lands on the customer balance. Without either, Stripe's own promo-code field is enabled at checkout.

post/v1/organizations/billing/subscribe

Request body

planstring required

Plan slug: managed_build, managed_scale, mvs_build, mvs_scale. The tier minimum is a billing floor — usage above it bills automatically at the plan's rates.

success_urlstring nullable

Redirect URL after successful subscription

cancel_urlstring nullable

Redirect URL if subscription is cancelled

promo_codestring nullable

Optional promo code to pre-apply at checkout. When combined with onboarding answers, the promo takes checkout's single discount slot and the onboarding credit lands on the customer balance.

Example request

{
  "plan": "managed_build"
}

Response

Successful Response

checkout_urlstring required

Stripe Checkout URL for subscription

session_idstring required

Stripe Checkout Session ID (empty string for inline upgrades)

Example response

{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_abc123",
  "session_id": "cs_live_abc123"
}