What’s actually changing
Cloudflare is reorganizing its storage APIs under a unified /storage/ namespace: Workers KV moves to /storage/kv/, R2 moves to /storage/r2/. Storage is becoming a first-class platform product, not a Workers-specific feature bolted under /workers/.
Cloudflare’s own changelog entry states it directly:
“The legacy Workers KV API routes under
/accounts/{account_id}/workers/namespaces/*are deprecated”
Published 2026-07-15, with an end-of-life date of 2026-10-15, exactly 90 days out from publication, a fairly tight window for infrastructure code that isn’t actively maintained.
Wrangler itself already handles this
If your project only touches KV through wrangler kv namespace create,
wrangler kv key put, or the runtime binding declared in
wrangler.toml/wrangler.jsonc, Cloudflare’s own tooling is responsible for
calling a working endpoint. This deprecation is only a problem for code that
calls the REST API directly, outside Wrangler.
Structural Comparison Matrix
All paths below are relative to /accounts/{account_id}.
| Operational Aspect | Legacy route (deprecated) | Current route |
|---|---|---|
| Base path | /workers/namespaces/* | /storage/kv/namespaces/* |
| Request parameters | Unchanged | Identical to legacy |
| Response payload shape | Unchanged | Identical to legacy |
| Availability after 2026-10-15 | Removed | Active |
Fix it: change one URL segment
curl -X GET \
"https://api.cloudflare.com/client/v4/accounts/<account_id>/workers/namespaces" \
-H "Authorization: Bearer <api_token>"curl -X GET \
"https://api.cloudflare.com/client/v4/accounts/<account_id>/storage/kv/namespaces" \
-H "Authorization: Bearer <api_token>"The same substitution applies to every route under this prefix: listing namespaces, reading/writing keys, and bulk operations all move from /workers/namespaces/ to /storage/kv/namespaces/ with no other change required. Grep infrastructure code for the literal string workers/namespaces to find every call site before the October cutoff:
grep -rn "workers/namespaces" --include="*.tf" --include="*.sh" --include="*.mjs" .This site’s own wrangler.toml declares two real KV namespace bindings (COUNTERS_KV, SESSION_KV), so if a script here ever called the KV REST API directly against those same namespace IDs, instead of going through Wrangler, this is the exact path change it would need before 2026-10-15.
Confirmed version
Sourced from Cloudflare’s official changelog, “Deprecate legacy Workers KV namespace API routes,” published 2026-07-15. Browse more posts like this in the Data Automation archive.
