docs: add documentation for wrangler pages deployment delete command

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>

Author: devin-ai-integration[bot]

src/content/docs/pages/configuration/api.mdx

@@ -64,6 +64,10 @@ After you have deployed the JavaScript Worker, set a cron trigger in your Worker
 
 Cloudflare Pages hosts and serves all project deployments on preview links. Suppose you want to keep your project private and prevent access to your old deployments. You can use the API to delete deployments after a month, so that they are no longer public online. The latest deployment for a branch cannot be deleted.
 
+:::note
+To delete individual deployments from the command line, you can use [`wrangler pages deployment delete`](/workers/wrangler/commands/#deployment-delete).
+:::
+
 ```js
 const endpoint =
 	"https://api.cloudflare.com/client/v4/accounts/{account_id}/pages/projects/{project_name}/deployments";

src/content/docs/pages/configuration/preview-deployments.mdx

@@ -70,6 +70,20 @@ To view branch aliases within your Pages project, select **View build** for any
 
 You can attach a Preview alias to a custom domain by [adding a custom domain to a branch](https://developers.cloudflare.com/pages/how-to/custom-branch-aliases/).
 
+## Delete preview deployments
+
+To clean up old preview deployments, you can delete them using Wrangler:
+
+```sh
+npx wrangler pages deployment delete <DEPLOYMENT_ID> --project-name <PROJECT_NAME>
+```
+
+Use the `--force` (or `-f`) flag to skip the confirmation prompt, which is useful for CI/CD automation. You can find deployment IDs by running [`wrangler pages deployment list`](/workers/wrangler/commands/#deployment-list).
+
+:::note
+The latest deployment for a branch cannot be deleted.
+:::
+
 ## Preview indexing by search engines
 
 To maintain a healthy SEO profile, it's vital to prevent search engines from finding duplicate content across the web. Because preview deployments are designed to be an exact replica of your production environment, they inherently create this exact situation. Cloudflare Pages by default ensures your search rankings are not harmed by these temporary previews.

src/content/docs/pages/platform/known-issues.mdx

@@ -95,31 +95,13 @@ If you have an issue that you do not see listed, let the team know in the Cloudf
 
 You may not be able to delete your Pages project if it has a high number (over 100) of deployments. The Cloudflare team is tracking this issue.
 
-As a workaround, review the following steps to delete all deployments in your Pages project. After you delete your deployments, you will be able to delete your Pages project.
-
-1. Download the `delete-all-deployments.zip` file by going to the following link: [https://pub-505c82ba1c844ba788b97b1ed9415e75.r2.dev/delete-all-deployments.zip](https://pub-505c82ba1c844ba788b97b1ed9415e75.r2.dev/delete-all-deployments.zip).
-2. Extract the `delete-all-deployments.zip` file.
-3. Open your terminal and `cd` into the `delete-all-deployments` directory.
-4. In the `delete-all-deployments` directory, run `npm install` to install dependencies.
-5. Review the following commands to decide which deletion you would like to proceed with:
-
-- To delete all deployments except for the live production deployment (excluding [aliased deployments](https://developers.cloudflare.com/pages/configuration/preview-deployments/#preview-aliases)):
-
-```sh
-CF_API_TOKEN=<YOUR_CF_API_TOKEN> CF_ACCOUNT_ID=<ACCOUNT_ID> CF_PAGES_PROJECT_NAME=<PROJECT_NAME> npm start
-```
-
-- To delete all deployments except for the live production deployment (including [aliased deployments](https://developers.cloudflare.com/pages/configuration/preview-deployments/#preview-aliases), for example, `staging.example.pages.dev`):
+As a workaround, you can use [`wrangler pages deployment delete`](/workers/wrangler/commands/#deployment-delete) to delete deployments individually. After you delete your deployments, you will be able to delete your Pages project.
 
 ```sh
-CF_API_TOKEN=<YOUR_CF_API_TOKEN> CF_ACCOUNT_ID=<ACCOUNT_ID> CF_PAGES_PROJECT_NAME=<PROJECT_NAME> CF_DELETE_ALIASED_DEPLOYMENTS=true npm start
+npx wrangler pages deployment delete <DEPLOYMENT_ID> --project-name <PROJECT_NAME>
 ```
 
-To find your Cloudflare API token, log in to the [Cloudflare dashboard](https://dash.cloudflare.com), select the user icon on the upper righthand side of your screen > go to **My Profile** > **API Tokens**.
-
-You need a token with `Cloudflare Pages Edit` permissions.
-
-To find your Account ID, refer to [Find your zone and account ID](/fundamentals/account/find-account-and-zone-ids/).
+Use the `--force` flag to skip the confirmation prompt, which is useful for scripting bulk deletions.
 
 ## Use Pages as Origin in Cloudflare Load Balancer