[wrangler] fix: pass force query parameter to API in pages deployment delete

[naile]

Improves #12474 — the --force flag was introduced but not wired to the API.

wrangler pages deployment delete --force only skips the confirmation prompt — it does not pass ?force=true to the Cloudflare API. This causes deletion of aliased deployments (branch preview deployments) to fail with error 8000035, breaking automated cleanup of preview environments in CI/CD pipelines.

The existing wrangler delete (Workers) already passes force as a query parameter to the API via URLSearchParams. This PR brings pages deployment delete in line with that behavior.

---

• 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:

[changeset-bot]

🦋 Changeset detected

Latest commit: 2483b52

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

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[pkg-pr-new]

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

wrangler

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

commit: 2483b52

[petebacondarwin]

Does this API parameter even exist?

https://developers.cloudflare.com/api/resources/pages/subresources/projects/subresources/deployments/methods/delete

compare with

https://developers.cloudflare.com/api/resources/workers/subresources/scripts/methods/delete

[naile]

Does this API parameter even exist?

https://developers.cloudflare.com/api/resources/pages/subresources/projects/subresources/deployments/methods/delete

compare with

https://developers.cloudflare.com/api/resources/workers/subresources/scripts/methods/delete

That's very interesting it's not documented, did not realize :)
The API itself names the parameter in its error response, and you can verify it end‑to‑end with curl:

Without force (current wrangler behavior):

DELETE https://api.cloudflare.com/client/v4/accounts/<account>/pages/projects/<project>/deployments/<deployment-id>
  HTTP 400
  {
    "result": null,
    "success": false,
    "errors": [
      {
        "code": 8000035,
        "message": "You cannot delete an aliased deployment without a `?force=true` parameter in the API request URL."
      }
    ],
    "messages": []
  }

With ?force=true (what this PR sends):

DELETE https://api.cloudflare.com/client/v4/accounts/<account>/pages/projects/<project>/deployments/<deployment-id>?force=true
 HTTP 200
 {
   "result": null,
   "success": true,
   "errors": [],
   "messages": []
 }

[jamesopstad]

Thanks for this and apologies for the confusion. We've checked with the relevant team and the docs have now been updated.

[workers-devprod]

Codeowners reviews satisfied

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

[robertsapunarich]

Thanks @jamesopstad and @naile . We also updated the API docs to reflect reality.

cc @petebacondarwin

[petebacondarwin]

I'll need to update the dev docs too: cloudflare/cloudflare-docs#28200