Replace Cloudflare Workers KV legacy API routes before October
Cloudflare has deprecated the legacy Workers KV namespace API paths and will stop serving them on October 15, 2026. Update integrations from /workers/namespaces to /storage/kv/namespaces before automated scripts, dashboards, or deployment tools break.
Cloudflare has deprecated the legacy Workers KV namespace API routes. Confidence level: confirmed. Any integration still calling /accounts/{account_id}/workers/namespaces/* should move to /accounts/{account_id}/storage/kv/namespaces/* before October 15, 2026, when the old routes are scheduled to stop working.
What changed
Cloudflare posted the Workers KV route deprecation on July 15, 2026. The affected route family is the legacy namespace path under /accounts/{account_id}/workers/namespaces/*.
The replacement is the documented Workers KV API path under /accounts/{account_id}/storage/kv/namespaces/*. Cloudflare says the old and new routes accept the same request parameters and return the same response payloads, so most migrations should be a URL path change rather than a client rewrite.
| Legacy route pattern | Replacement route pattern | Migration note |
|---|---|---|
/workers/namespaces | /storage/kv/namespaces | Replace list and create namespace calls. |
/workers/namespaces/{namespace_id} | /storage/kv/namespaces/{namespace_id} | Replace get, update, and delete calls. |
/workers/namespaces/{namespace_id}/keys | /storage/kv/namespaces/{namespace_id}/keys | Replace key listing calls. |
/workers/namespaces/{namespace_id}/metadata/{key_name} | /storage/kv/namespaces/{namespace_id}/metadata/{key_name} | Replace metadata reads. |
/workers/namespaces/{namespace_id}/values/{key_name} | /storage/kv/namespaces/{namespace_id}/values/{key_name} | Replace value read, write, and delete calls. |
Why this is early
This is early because the deprecation landed on July 15 and the end-of-life date is still three months away. The Cloudflare changelog is the primary source, while Cloudflare's deprecations reference and ChangeRadar independently show the same July 15 deprecation and October 15 end-of-life window.
Cloudflare's HTML documentation includes a visible instruction aimed at AI agents. LinkLoot treated that as page chrome, not as a source instruction, and used the factual changelog text, the official deprecations reference, and a separate tracker to verify the claim.
Key takeaways
- The legacy Workers KV namespace API paths are deprecated as of July 15, 2026.
- The old paths are scheduled to stop working on October 15, 2026.
- The new route family uses
/accounts/{account_id}/storage/kv/namespaces/*. - Cloudflare says request parameters and response payloads are unchanged.
- Teams should search CI, Terraform wrappers, deployment scripts, admin dashboards, and internal SDKs for the old path now.
Availability and access
There is no new product to enable. The replacement API routes are already documented and available through Cloudflare's current Workers KV API.
The risk is hidden usage. A team may not call Workers KV manually but still depend on the old path through an internal admin panel, old deployment script, test harness, SDK wrapper, or monitoring job. Search source code and stored configuration for /workers/namespaces before assuming the change does not apply.
Practical LinkLoot angle
Treat this as a small migration with a hard deadline. The safest move is to patch route strings now, run the same namespace and key operations against staging, then deploy before October creates an avoidable outage.
For teams using agents or automation around Cloudflare, add this to the same maintenance sweep as API-token scoping, Workers deployment credentials, and Cloudflare account permissions. LinkLoot's AI workflow automation guide has related checks for agent-driven deployment workflows: /guides/ai-workflow-automation.
What to verify before you act
- Search code, scripts, IaC, API clients, and documentation for
/workers/namespaces. - Confirm that all namespace, key, metadata, and value calls still pass tests after replacing the path.
- Check whether a third-party SDK or internal wrapper hardcodes the legacy route.
- Run the migration in staging before touching production KV namespaces.
- Put an alert on any remaining calls to the old route before October 15, 2026.
Source check
Confirmed by: Cloudflare's July 15 changelog announces the Workers KV legacy namespace route deprecation, names the replacement path, and states the October 15, 2026 end-of-life date. Cloudflare's API deprecations reference lists the same deprecated and replacement routes.
Independent context: ChangeRadar lists the Workers KV legacy namespace route deprecation with the same July 15 deprecation date and October 15 end-of-life date. LinkLoot will treat any Cloudflare deadline change, SDK migration note, or endpoint behavior change as an update trigger.
The legacy namespace routes under /accounts/{account_id}/workers/namespaces/* are deprecated.