Overview

Delete one or all future phases from a subscription schedule. Useful when a customer wants to undo a scheduled renewal or when replacing renewal offers.

Modes

Mode	Behavior
`last_phase` (default)	Deletes only the last future phase
`all_phases`	Deletes all future phases, leaving only the current phase

Restrictions

Condition	Result
Subscription has no schedule	404 error
Subscription has only one phase	422 error
No future phases exist	422 error
Phase is a gifted renewal	Cannot be deleted

Behavior After Deletion

Auto-renew plan: After deleting all phases, end_behavior is set to release (subscription will auto-renew after the last remaining phase)
Self-renew plan: After deleting all phases, end_behavior is set to cancel (subscription expires after the last remaining phase)
Advance invoices for deleted phases are voided or refunded depending on payment status

Webhook

No explicit webhook event is dispatched for phase deletion. The subscription model update may trigger subscription.updated via the Eloquent observer if the subscription record is saved during the operation.

200Success.

400Invalid request.

401Unauthenticated.

404Not found.

500Server error.