Upgrade & Downgrade
How plan changes work, what happens to your cues.
Upgrading
When you upgrade:
- Your new limits take effect immediately after payment
- Previously paused cues (from a downgrade) can be resumed
- Rate limits increase immediately
- Usage counters are not reset — they continue from the current month
Downgrading
When you cancel or downgrade to Free:
- Your current plan remains active until the end of the billing period
- At the end of the period, limits revert to Free plan
- If you have more active cues than the Free limit (10), excess cues are paused automatically
- Cues are paused newest-first (oldest cues are preserved)
What gets paused
Only the status changes to paused. The cue's schedule, callback, payload, and execution history are preserved. You can:
- Delete the paused cues
- Re-upgrade to resume them
- Resume them manually if you're under the limit (by deleting other cues first)
Plan change via Stripe webhook
Plan changes are processed via Stripe webhooks:
| Event | Action |
|---|---|
checkout.session.completed | Upgrade limits |
customer.subscription.updated | Adjust limits |
customer.subscription.deleted | Downgrade to Free |
invoice.payment_failed | Logged (no immediate action) |
No data loss
CueAPI never deletes cues or execution history during plan changes. Downgrades only pause excess cues.