Skip to main content

UpdatePlan modifies an existing subscription plan.

PATCH 
/api/v1/billing/plans/:id

Updates specified fields of an existing plan. Only provided fields are updated; omitted fields retain their current values. Changes take effect immediately but do not affect existing subscriptions until renewal.

Authorization​

Requires billing:admin permission.

Important Notes​

  • Price changes do not affect existing subscriptions until renewal
  • Changing is_active to false hides the plan from new subscriptions
  • Feature/limit changes may affect subscription capacity checks

Response​

Returns the updated Plan with new values and updated_at timestamp.

Errors​

  • NOT_FOUND: Plan with specified ID does not exist
  • PERMISSION_DENIED: Caller lacks billing:admin permission
  • INVALID_ARGUMENT: Validation failed for provided fields

Request​

Responses​

A successful response.