[wrangler] feat: add pages deployment delete command

[petebacondarwin]

Fixes #2438.

Adds a new CLI command wrangler pages deployment delete that allows users to delete Pages deployments directly from the command line. This is particularly useful for CI/CD pipelines that need to programmatically clean up old preview deployments.

Usage

# Interactive (with confirmation prompt)
wrangler pages deployment delete <deployment-id> --project-name <name>

# Skip confirmation (for CI/CD automation)
wrangler pages deployment delete <deployment-id> --project-name <name> --force
wrangler pages deployment delete <deployment-id> --project-name <name> -f

Implementation Details

• Follows existing patterns from pagesDeploymentListCommand and pagesProjectDeleteCommand
• Requires confirmation by default to prevent accidental deletions
• Supports --force / -f flag to skip confirmation for automation
• Adds metrics event tracking for the new command

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s): docs: add documentation for wrangler pages deployment delete command cloudflare-docs#28200
  • Documentation not necessary because: The command is self-documenting via --help and follows existing patterns

A picture of a cute animal (not mandatory, but encouraged)

🦝

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 92f08b4

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[claude]

Claude finished @petebacondarwin's task —— View job

---

Changeset Review

• Read changeset guidelines
• Review changeset file
• Validate against criteria
• Post findings

---

✅ All changesets look good

The changeset .changeset/delete-pages-deployment.md is well-formatted and follows all guidelines:

• ✅ Version type: minor is correct for a new CLI command
• ✅ Changelog quality: Clear description with usage example
• ✅ Markdown headers: No h1/h2/h3 headers used
• ✅ Analytics: N/A for this change
• ✅ Format: Follows the recommended structure with title and body

---

Cuteness Report

This is Darwin's raccoon. He's a trash panda in markdown form and represents this deployment delete feature perfectly—cleaning up after everyone. Excellent choice for a cleanup command. 13/10 would delete deployments with.

---

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12474

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12474

miniflare

npm i https://pkg.pr.new/miniflare@12474

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12474

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12474

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12474

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12474

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12474

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12474

wrangler

npm i https://pkg.pr.new/wrangler@12474

commit: 92f08b4

[petebacondarwin]

Tested manually with the PR preview to prove that the backend APIs are actually there and work as expected.

[devin-ai-integration]

Devin Review found 1 potential issue.

View 3 additional findings in Devin Review.

[vicb]

See inline comments

Comments have been addressed.