Delete descendant branches with branch deletion

March 27, 2026

Deleting a branch now includes an option to recursively delete its descendant branches in the same action.

This option is available across the PlanetScale app, CLI, and API:

• Web app: Select Also delete descendants in the delete confirmation dialog.
• CLI: Run pscale branch delete <DATABASE_NAME> <BRANCH_NAME> --delete-descendants.
• API: Send DELETE /v1/organizations/{organization}/databases/{database}/branches/{branch}?delete_descendants=true.

Without this option, branch deletion behavior is unchanged.

Read more:

• CLI branch command
• Delete branch API reference