← All breaking-change reports

Cloudflare deprecation: KV - Deprecate legacy Workers KV namespace API routes

cloudflare · deprecation · 2026-07-15 · upstream source

What changed

From the upstream announcement:

The legacy Workers KV API routes under /accounts/{account_id}/workers/namespaces/ are deprecated as of July 15, 2026, and will stop working on October 15, 2026. Migrate to the documented Workers KV API routes under /accounts/{account_id}/storage/kv/namespaces/ before that date. The legacy and replacement routes are interchangeable. They accept the same request parameters and return the same response payloads. To migrate, update the URL path from /workers/namespaces/ to /storage/kv/namespaces/ . What you need to do Update any integration that calls a route under /accounts/{account_id}/workers/namespaces/ to use the equivalent route under /accounts/{account_id}/storage/kv/namespaces/ . The migration is a direct URL path substitution — request parameters and response payloads are identical: GET and POST /accounts/{account_id}/workers/namespaces → GET and POST /accounts/{account_id}/storag […]

Who is affected

Codebases that call the Cloudflare API surface named above.

To find out whether your repo is hit — file and line number, no code leaving your machine:

npx mendapi scan --repo .

How to fix it

mendapi ships a deterministic migration pack for this change (cloudflare-kv-legacy-routes). Preview the patch locally (dry-run is the default; nothing is modified without --apply):

npx mendapi fix --repo . --migration cloudflare-kv-legacy-routes

The pack is idempotent, gold-regression tested, and safe on partially migrated code.

Detected and tracked by mendapi — Dependabot for every API you depend on. Scans run locally; your code never leaves your machine.

Related

Pre-release. Change data is recorded from upstream provider releases, changelogs and OpenAPI spec diffs; every article links its source.