Sign in
organizations

Changed on

DEPRECATED: use change-package with explicit tiers, which applies every dimension — and the platform fee every non-Mighty plan carries — in one call. Upgrade the storage tier on the org's active Pro subscription. Modifies the Stripe subscription item in place and invoices immediately (always_invoice). Storage is upgrade-only — equal-tier requests are a no-op and smaller-tier requests are rejected with HTTP 400 before any Stripe call. Legacy (no-longer-offered) tiers are rejected with HTTP 400 unless they equal the current tier (which no-ops). On a successful change the org's assistants grow up to the new ceiling asynchronously, the same way a Base→Pro subscribe does; the response does not wait on that rollout. PVCs are never shrunk. Rejected with HTTP 409 while a cancellation is pending. Requires an active Pro subscription with storage_tier metadata; legacy subscriptions get HTTP 409 until they are migrated.

post/v1/organizations/billing/subscription/change-storage-tier/

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in cookie sessionid
    • API key in header X-Session-Token

Headers

Vellum-Organization-Idstring uuid

Required if using Cookie-based or X-Session-Token authentication methods.

Request body

storage_tier'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl' required
  • xs - xs
  • s - s
  • m - m
  • l - l
  • xl - xl
  • xxl - xxl

Response

status'ok' | 'no_op' required
  • ok - ok
  • no_op - no_op
storage_tier'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl' required
  • xs - xs
  • s - s
  • m - m
  • l - l
  • xl - xl
  • xxl - xxl

Changes