# Workers KV のレガシー API にサヨナラ！新ルートへは URL パス置換だけで OK

こんにちは、しぃちゃんだよ！今日は「今のうちにやっておかないと後で困る」系の大事なお知らせを持ってきたよ。

## なにが発表されたの？

Cloudflare の Changelog で、Workers KV のレガシー API ルートが非推奨になったと発表されたよ。対象は `/accounts/{account_id}/workers/namespaces/*` 配下のルートで、2026 年 7 月 15 日付けで非推奨となり、2026 年 10 月 15 日には完全に使えなくなる予定なの。

移行先は `/accounts/{account_id}/storage/kv/namespaces/*` という新しいルートだよ。原文によると、新旧のルートは「同じリクエストパラメータ・同じレスポンスペイロード」を返す互換関係にあって、移行は URL パスの `/workers/namespaces/` を `/storage/kv/namespaces/` に置き換えるだけで完了するの。

## 今までどうだったの？

これまでは `/accounts/{account_id}/workers/namespaces/` 配下のレガシールートで Workers KV を操作できていたよ。でも正式にドキュメント化されているのは `/storage/kv/namespaces/` 配下の新ルートの方で、レガシー側は今回のアナウンスで廃止スケジュールが明確になった形なの。

具体的に置き換わるエンドポイントはこんな感じ:

- `GET` / `POST` `.../workers/namespaces` → `.../storage/kv/namespaces`(ネームスペースの一覧・作成)
- `GET` / `PUT` / `DELETE` `.../workers/namespaces/{namespace_id}` → 同じメソッドで `.../storage/kv/namespaces/{namespace_id}`(ネームスペース単位の操作)
- `GET` `.../workers/namespaces/{namespace_id}/keys` → `.../storage/kv/namespaces/{namespace_id}/keys`(キー一覧)
- `GET` `.../workers/namespaces/{namespace_id}/metadata/{key_name}` → `.../storage/kv/namespaces/{namespace_id}/metadata/{key_name}`(メタデータ取得)
- `GET` / `PUT` / `DELETE` `.../workers/namespaces/{namespace_id}/values/{key_name}` → 同じメソッドで `.../storage/kv/namespaces/{namespace_id}/values/{key_name}`(値の取得・更新・削除)

## これで何が変わるの？

2026 年 10 月 15 日を過ぎると、レガシールートを呼んでいる統合や自作スクリプトはそのまま動かなくなるよ。対象になりやすいのは、自前で Workers KV の API を直接叩いている CI/CD スクリプトや、独自に組んだ SDK・管理ツールなど。移行そのものはパス文字列を置き換えるだけなので、影響範囲を洗い出せれば作業自体は軽めのはずだよ。

## まとめ

- Workers KV のレガシー API ルート(`/workers/namespaces/*`)が非推奨に
- 廃止(利用不可)になるのは 2026 年 10 月 15 日
- 新ルート `/storage/kv/namespaces/*` はパラメータもレスポンスも同一で、URL パスの置換だけで移行できる

自前で Workers KV の API を直接叩いている人は、忘れずに移行しておいてね！