OpenAICloudflare Developer PlatformJul 15, 2026, 12:00 AM

KV - Deprecate legacy Workers KV namespace API routes

A condensed section focused on the key takeaways first.

Original Post

OpenAI Claude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

KV - Deprecate legacy Workers KV namespace API routes

workers kv api deprecation migration namespaces

Key Points

Legacy KV namespace routes deprecated Jul 15 2026
Stop working Oct 15 2026 — migrate before then
Replace /workers/namespaces/ with /storage/kv/namespaces/

Summary

The legacy Workers KV API routes under /accounts/{account_id}/workers/namespaces/* are deprecated as of 2026-07-15 and will stop working on 2026-10-15. Migrate to the documented 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.

Key Points

Action required: update any integration that calls /accounts/{account_id}/workers/namespaces/ to use /accounts/{account_id}/storage/kv/namespaces/ before 2026-10-15.
Migration is a direct URL path substitution; request parameters and response payloads remain identical.
Common route mappings (examples):
- GET/POST /accounts/{account_id}/workers/namespaces → GET/POST /accounts/{account_id}/storage/kv/namespaces
- GET/PUT/DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} → same under /storage/kv/namespaces/{namespace_id}
- GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys → same under /storage/kv/namespaces/{namespace_id}/keys
- GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} → same under /storage/kv/namespaces/{namespace_id}/metadata/{key_name}
- GET/PUT/DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} → same under /storage/kv/namespaces/{namespace_id}/values/{key_name}

Recommended steps

Search codebase, CI configs, and integrations for /workers/namespaces/ and replace with /storage/kv/namespaces/.
Deploy changes to staging and run API/contract tests to confirm identical behavior.
Monitor production logs after cutover for any unexpected errors and plan a rollback window if needed.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

KV - レガシー Workers KV ネームスペース API ルートの廃止

概要

レガシーの Workers KV API ルート（/accounts/{account_id}/workers/namespaces/*）は 2026年7月15日をもって非推奨となり、2026年10月15日に機能しなくなります。これまでに、ドキュメント化された Workers KV API ルート（/accounts/{account_id}/storage/kv/namespaces/*）へ移行してください。

レガシーと置換後のルートは相互に置き換え可能で、同じリクエストパラメータを受け取り、同じレスポンスペイロードを返します。移行は URL パスの置換で完了します：/workers/namespaces/ を /storage/kv/namespaces/ に更新してください。

対応方法

/accounts/{account_id}/workers/namespaces/ 以下のルートを呼び出しているすべての統合（integration）を、同等の /accounts/{account_id}/storage/kv/namespaces/ に更新してください。
移行は直接の URL パス置換です。リクエストパラメータとレスポンスペイロードは同一です。

ルート対応表

GET および POST /accounts/{account_id}/workers/namespaces → GET および POST /accounts/{account_id}/storage/kv/namespaces
GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id} → GET, PUT, DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}
GET /accounts/{account_id}/workers/namespaces/{namespace_id}/keys → GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys
GET /accounts/{account_id}/workers/namespaces/{namespace_id}/metadata/{key_name} → GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name}
GET, PUT, DELETE /accounts/{account_id}/workers/namespaces/{namespace_id}/values/{key_name} → GET, PUT, DELETE /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}

参照

非推奨スケジュールの詳細については API deprecations を参照してください。