Package Exports

cloudflare-bulk-delete
cloudflare-bulk-delete/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cloudflare-bulk-delete) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Fix "Your project has too many deployments to be deleted"

The fastest way to bulk delete Cloudflare Pages and Workers deployments.

When Cloudflare shows "Your project has too many deployments to be deleted, follow this guide to delete them", this tool solves it in minutes instead of hours.

npm

The Problem

Cloudflare limits manual deletion when you have too many deployments. The official solution involves tedious manual API calls. This tool automates the entire process safely.

Before: Hours of manual API calls After: 3 commands, done in minutes

Example: Real Solution in Action

$ cf-bulk-delete interactive
✓ API connections successfully validated

=== Cloudflare Pages Projects ===
1. my-blog-site (247 deployments)
2. portfolio-app (156 deployments)
3. docs-site (89 deployments)

? Select resource to manage: my-blog-site
✓ Found 247/247 deployments for my-blog-site

? Choose action: Bulk delete deployments
? Select protection mode: Safe Mode (Recommended)

Preview: Will delete 245 deployments (keeping latest 2, skipping production)
? Proceed with deletion? Yes

⠋ Deleting deployments... 89/245 completed
✓ Cleanup completed: 245 succeeded, 0 failed
Duration: 2.3s | Rate: 106.5/s

Problem solved! 🎉

Common Error Messages This Tool Fixes

Cloudflare Dashboard Error:

❌ "Your project has too many deployments to be deleted, follow this guide to delete them: https://cfl.re/3CXesln"

Our Solution:

✅ cf-bulk-delete interactive - Delete hundreds of deployments in seconds

Quick Start

# 1. Install
npm install -g cloudflare-bulk-delete

# 2. Set your credentials
export CLOUDFLARE_API_TOKEN=your_token_here
export CLOUDFLARE_ACCOUNT_ID=your_account_id_here

# 3. Clean up deployments
cf-bulk-delete interactive

Installation

npm install -g cloudflare-bulk-delete

Setup

Get API Token: Create token with Cloudflare Pages:Edit and Workers Scripts:Write permissions
Find Account ID: Available in your Cloudflare Dashboard sidebar
Set Environment Variables:

export CLOUDFLARE_API_TOKEN=your_token_here
export CLOUDFLARE_ACCOUNT_ID=your_account_id_here

Usage

Interactive Mode (Recommended)

cf-bulk-delete interactive

Choose your resources, select protection level, confirm deletion.

Direct Commands

# List all resources
cf-bulk-delete list

# Preview cleanup (safe)
cf-bulk-delete delete pages my-project --max-age 30 --dry-run

# Execute cleanup
cf-bulk-delete delete pages my-project --max-age 30

# Clean old preview deployments only
cf-bulk-delete delete pages my-project --environment preview --max-age 7

Safety Features

Dry-run mode - Preview before deletion
Production protection - Skips production deployments by default
Latest deployment protection - Keeps most recent deployment
Batch processing - Rate-limited to avoid API throttling

Command Reference

# Core commands
cf-bulk-delete list                           # List all resources
cf-bulk-delete deployments pages my-project  # Show deployments
cf-bulk-delete delete pages my-project       # Bulk delete
cf-bulk-delete interactive                   # Interactive mode

# Options
--dry-run              # Preview only
--max-age <days>       # Delete older than X days
--environment <env>    # Target specific environment
--skip-production      # Skip production (default: true)
--batch-size <n>       # Process in batches (default: 10)

Examples

Emergency cleanup (keeps production safe):

cf-bulk-delete delete pages my-project --max-age 7 --dry-run
cf-bulk-delete delete pages my-project --max-age 7

Clean only preview deployments:

cf-bulk-delete delete pages my-project --environment preview --max-age 1

Workers version cleanup:

cf-bulk-delete delete workers my-script --max-age 30

Programmatic Usage

import { ServiceManager } from 'cloudflare-bulk-delete';

const manager = new ServiceManager(apiToken, accountId);

// Get deployments
const deployments = await manager.listDeployments('pages', 'my-project');

// Bulk delete
const result = await manager.bulkDeleteDeployments('pages', 'my-project', deployments, {
  skipProduction: true,
  dryRun: false
});

console.log(`Deleted: ${result.success}, Failed: ${result.failed}`);

Troubleshooting

"Invalid API Token"

Verify token permissions: Cloudflare Pages:Edit and Workers Scripts:Write
Check token hasn't expired

"Too Many Requests"

Tool has built-in rate limiting
Reduce batch size: --batch-size 5

Debug mode:

LOG_LEVEL=debug cf-bulk-delete list

License

MIT License - see LICENSE

Solves: Cloudflare "too many deployments to be deleted" error
Author: Rama Aditya
Repository: https://github.com/RamaAditya49/cloudflare-bulk-delete