Subscriptions (Enterprise only)
Workspace billing and subscriptions. Mixpost Enterprise only โ served under
/panel and restricted to admin users.
Get the workspace's default subscription
Returns the workspace's default subscription, including its monthly/yearly plan details.
Manually record a subscription
Records a subscription that already exists on your payment platform. This is a bookkeeping operation only โ **no payment platform is contacted** and no charge is made. To start a real checkout, use `POST /panel/workspaces/{workspace}/subscription/new` instead.
Manually update the recorded subscription
Updates the workspace's recorded default subscription directly. No payment platform is contacted, so this changes only what Mixpost has stored.
Delete the recorded subscription
Deletes the workspace's recorded default subscription. This removes Mixpost's record only โ **the subscription is not cancelled on the payment platform**. Use the cancel endpoint if you need a real cancellation.
Start a real subscription through the payment platform
Starts a **real** subscription for the workspace through the instance's active payment platform. Unlike `POST /panel/workspaces/{workspace}/subscription`, which only records an existing subscription, this endpoint contacts the payment platform and normally returns a checkout payload.
Swap the subscription to another plan
Swaps the workspace's subscription to a different plan and billing cycle, applying the requested proration. Requires an active payment platform, since the swap is performed there.
Cancel the subscription at period end
Cancels the workspace's subscription **at the end of the current billing period** rather than immediately, so access continues until the period ends.
Extend or shorten a trial
Moves the end of the workspace's running trial to another day: a later day extends the trial, an earlier one shortens it. The trial keeps its current time of day, and the day is read in the instance's timezone. Nothing is billed by the change itself; the customer is charged when the new trial end is reached.
End a trial now and charge
Ends the trial of the workspace's subscription right away: the payment platform charges the card on file for the first billing period and the subscription becomes active. The request takes no body.
Resume a paused or grace-period subscription
Resumes the workspace's default subscription. The request takes no body.
Add a generic (platform-less) subscription
Grants the workspace a generic subscription โ an internal subscription that exists only in Mixpost, with **no payment platform involved** and no charge.
Remove the generic subscription
Removes the workspace's generic subscription. The request takes no body.