Claude API Update: Agent Memory Listing Changes
Anthropic is introducing a new beta header, `agent-memory-2026-07-22`, for the List Memories endpoint, altering response ordering and parameter behavior. This change impacts how developers retrieve memory data and requires updates to SDK usage and explicit beta header configurations. The new header will eventually replace `managed-agents-2026-04-01` on July 22, 2026, and developers are advised to restart pagination when adopting it.
- →New beta header changes memory listing behavior
- →Header replacement and conflict handling
- →SDKs updated to send new memory listing beta header
Breaking changes (2) ›
- New beta header changes memory listing behavior
The `agent-memory-2026-07-22` beta header modifies the List Memories endpoint (`GET /v1/memory_stores/{memory_store_id}/memories`) to return results in a stable, server-defined order, ignoring `order_by` and `order` parameters. The `depth` parameter now only accepts `0`, `1`, or omission, and `path_prefix` must end with `/` and match whole path segments. Page cursors issued without this header are invalidated, necessitating a restart from the first page.
- Header replacement and conflict handling
The `agent-memory-2026-07-22` header replaces `managed-agents-2026-04-01` on memory store endpoints; sending both will result in a `400` error. The `managed-agents-2026-04-01` header will adopt the same listing behavior on July 22, 2026.
Enhancements (1) ›
- SDKs updated to send new memory listing beta header
The Python, TypeScript, Go, Java, Ruby, PHP, C#, and CLI SDKs have been updated to send the `agent-memory-2026-07-22` header on all memory store calls, replacing the previous `managed-agents-2026-04-01` header. Developers explicitly passing betas in their code should replace the old header with the new one.
https://platform.claude.com/docs/en/release-notes/overview