Skip to main content

UpdateBillingCycle changes the subscription billing cycle (monthly <-> yearly).

PUT 
/api/v1/billing/subscription/billing-cycle

Yearly billing provides a 20% discount on all channel fees. Change can be applied immediately (with proration) or at next billing period.

Authorization​

Requires billing:manage permission.

Behavior​

  • immediate=true: Change now, proration calculated
  • immediate=false: Change at next billing cycle

Errors​

  • NOT_FOUND: No subscription exists
  • INVALID_ARGUMENT: Invalid billing cycle value
  • PERMISSION_DENIED: Caller lacks billing:manage permission

Request​

Responses​

A successful response.