[wrangler] Allow deleting KV namespaces by name

[petebacondarwin]

Fixes #4193.

Allow deleting a KV namespace by providing its name as a positional argument:

wrangler kv namespace delete my-namespace

This aligns the delete command with the create and rename commands, which also accept namespace names. The existing --namespace-id and --binding flags continue to work as before.

Implementation

The namespace name lookup logic has been centralized in the getKVNamespaceId() helper, which now:

• Accepts an optional namespace parameter for lookup by name
• Returns { namespaceId, displayName } instead of just a string
• Formats displayName to show both the identifier and ID (e.g., my-binding (abc123))

This improves UX across all KV commands by showing more context in log messages.

---

• 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):
  • Documentation not necessary because: The CLI help text is updated automatically and the usage is intuitive

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

🐱

[changeset-bot]

🦋 Changeset detected

Latest commit: 355ab44

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
• Read changeset file
• Validate changeset
• Post review feedback

---

✅ All changesets look good

The changeset .changeset/kv-namespace-delete-by-name.md follows all guidelines:

1. ✅ Version Type: Minor is correct - this adds new functionality (positional argument support)
2. ✅ Changelog Quality: Clear description with usage example showing the new behavior
3. ✅ Markdown Headers: No h1/h2/h3 headers used
4. ✅ Format: Proper title + body structure with code example
5. ✅ Context: Explains alignment with existing create command and backward compatibility

The changeset effectively communicates the new feature to users and includes a practical example.

---

Cuteness Report: This is Cat. Appeared as an emoji in the PR description. Would rate but needs higher resolution for proper assessment. Still appreciated. 🐱/10

[pkg-pr-new]

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

@cloudflare/workers-utils

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

wrangler

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

commit: 355ab44

[petebacondarwin]

I have tested this manually using the PR preview to prove that the backend APIs being hit work as expected.

[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 5 additional findings.

[vicb]

See inline comments.

Could you please also fix the description ?

When deleting by name, the command will:

List all namespaces for the account
Find the namespace with the matching title
Delete the namespace by its ID
Display both the name and ID in the confirmation message

• explain why list, i.e. because no find by name
• title -> name
• "Display both the name and ID in the confirmation message" doesn't look like this is what is implemented

[petebacondarwin]

Don't land this until the KV team have reviewed and we have resolved the questions around the title vs name naming.

name vs title is being discussed with the KV team

[petebacondarwin]

All "title" references have been removed, except for tests that continue to respond with the same format as the API.
@vicb - PTAL.

[vicb]

LGTM with a few question.
Thanks for the updates

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 12 additional findings in Devin Review.