Billing

Upgrade the account plan

Changed on

Creates a hosted human-consent handoff for an upgrade. It never charges a saved payment method directly. Requires billing.manage and an Idempotency-Key header.

post/billing/upgrade

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/billing/upgrade
  • Auth: HTTP bearer

Request body

planKey'starter' | 'basic' | 'grow' | 'advanced' | 'scale' | 'enterprise' required

Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.

interval'monthly' | 'annual'

Billing interval. Defaults to monthly when omitted.

Response

Upgrade completed or checkout required.

object'billing_upgrade' required
status'human_action_required' required
urlstring uri required
planKey'starter' | 'basic' | 'grow' | 'advanced' | 'scale' | 'enterprise' required

Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.

Changes