Subscriptions

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.

📄️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.