Claude API

agent-memory-2026-07-22ヘッダー移行が本日発効 — managed-agents-2026-04-01との動作統一完了、メモリストアAPI利用者のブレークチェンジ対応を確認すべき

元記事を読む(platform.claude.com) ↗

Summary

7月22日（本日）にagent-memory-2026-07-22ベータヘッダーの移行が発効。managed-agents-2026-04-01ヘッダーがメモリストアエンドポイントで同一動作を採用し、両ヘッダー間の動作差異が解消。主要変更: (1)メモリリスト結果が安定サーバー定義順序で返却（order_by・orderパラメータ無視）、(2)depthは0・1・省略のみ許容（他値は400エラー）、(3)path_prefixは`/`終端必須・完全パスセグメントマッチに厳格化。managed-agents-2026-04-01とagent-memory-2026-07-22の同時送信は400エラー（ブレークチェンジ）。全8言語SDK（Python・TypeScript・Go・Java・Ruby・PHP・C#・Kotlin）が同時更新済み。本日以降の新規開発はagent-memory-2026-07-22ヘッダーの使用が推奨。

Key Takeaways

  • ▸ 本日発効のブレークチェンジ — メモリストアAPI利用中のアプリケーションで動作変更の影響を即時確認すべき
  • ▸ managed-agents-2026-04-01の動作がagent-memory-2026-07-22に統一 — 移行未実施でも動作が変更されるため、暗黙的に影響を受ける可能性
  • ▸ depth・path_prefixの厳格化で不正パラメータが即座に400エラー — 本番環境のエラーログを確認し想定外の400エラー増加がないかモニタリング
  • ▸ MCP 2026-07-28最終仕様公開まで残り6日 — Managed Agents固有移行とMCP本体移行が短期間に集中

Best Practice Updates

  • ✓ メモリストアAPI利用コードのベータヘッダーをagent-memory-2026-07-22に統一し、managed-agents-2026-04-01との同時送信を排除
  • ✓ メモリリスト順序がサーバー定義に統一されたため、クライアント側でソート依存していたコードを確認・修正
  • ✓ 既存ページカーソルは無効化されているため最初のページから再取得が必要

Same Day Signals

すべて見る →

元記事の著作権は各著作者に帰属します。