POST /admin/billing/subscription/{tenant_id}/change-plan

Switch the current subscription of a specified tenant to another plan (upgrade or downgrade), automatically calculating prorated charges. If the difference is positive, an invoice is generated; if negative, it is credited to the balance.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
tenant_id	path	string	Yes				Tenant ID

Request Body

Schema: dto.PlanChangeRequest

Field	Type	Required	Example	Constraints	Description
new_plan	string	Yes	enterprise
billing_cycle	string	No	monthly

Responses

Status	Description	Schema
200	Plan change successful, including prorated charges	object
400	Invalid request parameters	object
401	Unauthorized	object
403	No permission	object
500	Internal server error	object