Memory Stores
api/beta/memory_stores
History
api/beta/memory_stores Changed · +220 / -24 lines
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Body parameters - `name: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `data: optional array of BetaManagedAgentsMemoryStore`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `BetaManagedAgentsMemoryStore object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Body parameters - `description: optional string or null`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `BetaManagedAgentsDeletedMemoryStore object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `BetaManagedAgentsMemoryStore object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Body parameters - `content: string or null`
- `memory_version_id: string` - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). + ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - `path: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `data: optional array of BetaManagedAgentsMemoryListItem`
- `memory_version_id: string` - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). + ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - `path: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `BetaManagedAgentsMemory object`
- `memory_version_id: string` - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). + ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - `path: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Body parameters - `content: optional string or null`
- `memory_version_id: string` - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). + ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - `path: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `BetaManagedAgentsDeletedMemory object` - Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted. + Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted). - `id: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `data: optional array of BetaManagedAgentsMemoryVersion`
- `memory_id: string` - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. + ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained. - `memory_store_id: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `BetaManagedAgentsMemoryVersion object` - A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. + A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. - `id: string`
- `memory_id: string` - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. + ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained. - `memory_store_id: string`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `BetaManagedAgentsMemoryVersion object` - A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. + A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. - `id: string`
- `memory_id: string` - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. + ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained. - `memory_store_id: string`
api/beta/memory_stores Changed · +444 / -929 lines
### Headers ### Body parameters #### Response (200) ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers ### Body parameters #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ## Memory Stores › Memories ### Create a memory #### Path parameters #### Query parameters #### Headers #### Body parameters #### Returns #### Example ##### Response (200) ### List memories #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Retrieve a memory #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Update a memory #### Path parameters #### Query parameters #### Headers #### Body parameters #### Returns #### Example ##### Response (200) ### Delete a memory #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Memory Stores › Memory Versions ### List memory versions #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Retrieve a memory version #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Redact a memory version #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Header Parameters ### Body Parameters #### Response ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters ### Body Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types # Memories ## Create a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ## List memories ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Retrieve a memory ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Update a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters #### Response ## Delete a memory ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Domain Types ### Beta Managed Agents Conflict Error ### Beta Managed Agents Content Sha256 Precondition ### Beta Managed Agents Deleted Memory ### Beta Managed Agents Error ### Beta Managed Agents Memory ### Beta Managed Agents Memory List Item ### Beta Managed Agents Memory Path Conflict Error ### Beta Managed Agents Memory Precondition Failed Error ### Beta Managed Agents Memory Prefix ### Beta Managed Agents Memory View ### Beta Managed Agents Precondition # Memory Versions ## List memory versions ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Retrieve a memory version ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Redact a memory version ### Path Parameters ### Header Parameters #### Response ## Domain Types ### Beta Managed Agents Actor ### Beta Managed Agents API Actor ### Beta Managed Agents Memory Version ### Beta Managed Agents Memory Version Operation ### Beta Managed Agents Service Account Actor ### Beta Managed Agents Session Actor ### Beta Managed Agents User Actor
The two sides of this change are too far apart to line up, so this is the differ's own diff of it.
---- -title: Memory Stores -url: https://platform.claude.com/docs/en/api/beta/memory_stores ---- - # Memory Stores ## Create a memory store -**post** `/v1/memory_stores` +**POST** `/v1/memory_stores` Create a memory store -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Body Parameters +### Body parameters - `name: string` Human-readable name for the store. Required; 1–255 characters; no control characters. The mount-path slug under `/mnt/memory/` is derived from this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be unique within a workspace. + minLength: 1, maxLength: 255 + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. + maxLength: 1024 + - `metadata: optional map[string]` Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Not visible to the agent. ### Returns -- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }` +- `BetaManagedAgentsMemoryStore object` A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \
}' ``` -#### Response +#### Response (200) ```json {
## List memory stores -**get** `/v1/memory_stores` +**GET** `/v1/memory_stores` List memory stores -### Query Parameters +### Query parameters - `"created_at[gte]": optional string` Return only stores whose `created_at` is at or after this time (inclusive). Sent on the wire as `created_at[gte]`. + format: date-time + - `"created_at[lte]": optional string` Return only stores whose `created_at` is at or before this time (inclusive). Sent on the wire as `created_at[lte]`. + format: date-time + - `include_archived: optional boolean` When `true`, archived stores are included in the results. Defaults to `false` (archived stores are excluded).
Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted. + format: int32 + - `page: optional string` Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page. -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
## Retrieve a memory store -**get** `/v1/memory_stores/{memory_store_id}` +**GET** `/v1/memory_stores/{memory_store_id}` Retrieve a memory store -### Path Parameters +### Path parameters - `memory_store_id: string` -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
### Returns -- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }` +- `BetaManagedAgentsMemoryStore object` A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
## Update a memory store -**post** `/v1/memory_stores/{memory_store_id}` +**POST** `/v1/memory_stores/{memory_store_id}` Update a memory store -### Path Parameters +### Path parameters - `memory_store_id: string` -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Body Parameters +### Body parameters - `description: optional string or null` New description for the store, up to 1024 characters. Pass an empty string to clear it. + maxLength: 1024 + - `metadata: optional map[string] or null` Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.
New human-readable name for the store. 1–255 characters; no control characters. Renaming changes the slug used for the store's `mount_path` in sessions created after the update. + minLength: 1, maxLength: 255 + ### Returns -- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }` +- `BetaManagedAgentsMemoryStore object` A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \
-d '{}' ``` -#### Response +#### Response (200) ```json {
## Delete a memory store -**delete** `/v1/memory_stores/{memory_store_id}` +**DELETE** `/v1/memory_stores/{memory_store_id}` Delete a memory store -### Path Parameters +### Path parameters - `memory_store_id: string` -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
### Returns -- `BetaManagedAgentsDeletedMemoryStore object { id, type }` +- `BetaManagedAgentsDeletedMemoryStore object` Confirmation that a `memory_store` was deleted.
- `type: "memory_store_deleted"` - - `"memory_store_deleted"` - ### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
## Archive a memory store -**post** `/v1/memory_stores/{memory_store_id}/archive` +**POST** `/v1/memory_stores/{memory_store_id}/archive` Archive a memory store -### Path Parameters +### Path parameters - `memory_store_id: string` -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
### Returns -- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }` +- `BetaManagedAgentsMemoryStore object` A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
### Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/archive \ -X POST \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
} ``` -## Domain Types +## Domain types ### Beta Managed Agents Deleted Memory Store -- `BetaManagedAgentsDeletedMemoryStore object { id, type }` +- `BetaManagedAgentsDeletedMemoryStore object` Confirmation that a `memory_store` was deleted.
- `type: "memory_store_deleted"` - - `"memory_store_deleted"` - ### Beta Managed Agents Memory Store -- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }` +- `BetaManagedAgentsMemoryStore object` A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
A timestamp in RFC 3339 format + format: date-time + - `name: string` Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name. - `type: "memory_store"` - - `"memory_store"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `archived_at: optional string or null` A timestamp in RFC 3339 format + format: date-time + - `description: optional string` Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable. -# Memories - -## Create a memory - -**post** `/v1/memory_stores/{memory_store_id}/memories` +## Memory Stores › Memories + +### Create a memory + +**POST** `/v1/memory_stores/{memory_store_id}/memories` Create a memory -### Path Parameters +#### Path parameters - `memory_store_id: string` -### Query Parameters +#### Query parameters - `view: optional BetaManagedAgentsMemoryView`
- `"full"` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Body Parameters +#### Body parameters - `content: string or null`
Hierarchical path for the new memory, e.g. `/projects/foo/notes.md`. Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. -### Returns - -- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` + minLength: 2, maxLength: 1024 + +#### Returns + +- `BetaManagedAgentsMemory object` A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. + format: int32 + - `created_at: string` A timestamp in RFC 3339 format + format: date-time + - `memory_store_id: string` ID of the memory store this memory belongs to (a `memstore_...` value).
- `type: "memory"` - - `"memory"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `content: optional string or null` The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \
}' ``` -#### Response +##### Response (200) ```json {
} ``` -## List memories - -**get** `/v1/memory_stores/{memory_store_id}/memories` +### List memories + +**GET** `/v1/memory_stores/{memory_store_id}/memories` List memories -### Path Parameters +#### Path parameters - `memory_store_id: string` -### Query Parameters +#### Query parameters - `depth: optional number` `0` (or omitted) returns all descendants below `path_prefix` (recursive). `1` returns immediate children only; deeper entries roll up as `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves like `find`. + format: int32 + - `limit: optional number` Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when `view=full`. Both `memory` and `memory_prefix` items count toward the limit. + format: int32 + - `page: optional string` Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
- `"full"` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +#### Returns - `data: optional array of BetaManagedAgentsMemoryListItem` One page of results. Each item is either a `memory` object or, when `depth` was set, a `memory_prefix` rollup marker. Items are returned in a stable, server-defined order. - - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` + - `BetaManagedAgentsMemory object` A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. + format: int32 + - `created_at: string` A timestamp in RFC 3339 format + format: date-time + - `memory_store_id: string` ID of the memory store this memory belongs to (a `memstore_...` value).
- `type: "memory"` - - `"memory"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `content: optional string or null` The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). - - `BetaManagedAgentsMemoryPrefix object { path, type }` + - `BetaManagedAgentsMemoryPrefix object` A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
- `type: "memory_prefix"` - - `"memory_prefix"` - - `next_page: optional string or null` Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request. -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} ``` -## Retrieve a memory - -**get** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` +### Retrieve a memory + +**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` Retrieve a memory -### Path Parameters +#### Path parameters - `memory_store_id: string` - `memory_id: string` -### Query Parameters +#### Query parameters - `view: optional BetaManagedAgentsMemoryView`
- `"full"` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns - -- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` +#### Returns + +- `BetaManagedAgentsMemory object` A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. + format: int32 + - `created_at: string` A timestamp in RFC 3339 format + format: date-time + - `memory_store_id: string` ID of the memory store this memory belongs to (a `memstore_...` value).
- `type: "memory"` - - `"memory"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `content: optional string or null` The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} ``` -## Update a memory - -**post** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` +### Update a memory + +**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` Update a memory -### Path Parameters +#### Path parameters - `memory_store_id: string` - `memory_id: string` -### Query Parameters +#### Query parameters - `view: optional BetaManagedAgentsMemoryView`
- `"full"` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Body Parameters +#### Body parameters - `content: optional string or null`
New path for the memory (a rename). Must start with `/`, contain at least one non-empty segment, and be at most 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or format characters, and must be NFC-normalized. Paths are case-sensitive. The memory's `id` is preserved across renames. Omit to leave the path unchanged. + minLength: 2, maxLength: 1024 + - `precondition: optional BetaManagedAgentsPrecondition` Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409. - `type: "content_sha256"` - - `"content_sha256"` - - `content_sha256: optional string` Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes. -### Returns - -- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` +#### Returns + +- `BetaManagedAgentsMemory object` A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. + format: int32 + - `created_at: string` A timestamp in RFC 3339 format + format: date-time + - `memory_store_id: string` ID of the memory store this memory belongs to (a `memstore_...` value).
- `type: "memory"` - - `"memory"` - - `updated_at: string` A timestamp in RFC 3339 format + format: date-time + - `content: optional string or null` The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \
-d '{}' ``` -#### Response +##### Response (200) ```json {
} ``` -## Delete a memory - -**delete** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` +### Delete a memory + +**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}` Delete a memory -### Path Parameters +#### Path parameters - `memory_store_id: string` - `memory_id: string` -### Query Parameters +#### Query parameters - `expected_content_sha256: optional string` Query parameter for expected_content_sha256 -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns - -- `BetaManagedAgentsDeletedMemory object { id, type }` +#### Returns + +- `BetaManagedAgentsDeletedMemory object` Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
- `type: "memory_deleted"` - - `"memory_deleted"` - -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} ``` -## Domain Types - -### Beta Managed Agents Conflict Error - -- `BetaManagedAgentsConflictError object { type, message }` - - - `type: "conflict_error"` - - - `"conflict_error"` - - - `message: optional string` - -### Beta Managed Agents Content Sha256 Precondition - -- `BetaManagedAgentsContentSha256Precondition object { type, content_sha256 }` - - Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409. - - - `type: "content_sha256"` - - - `"content_sha256"` - - - `content_sha256: optional string` - - Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes. - -### Beta Managed Agents Deleted Memory - -- `BetaManagedAgentsDeletedMemory object { id, type }` - - Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted. +## Memory Stores › Memory Versions + +### List memory versions + +**GET** `/v1/memory_stores/{memory_store_id}/memory_versions` + +List memory versions + +#### Path parameters + +- `memory_store_id: string` + +#### Query parameters + +- `api_key_id: optional string` + + Query parameter for api_key_id + +- `"created_at[gte]": optional string` + + Return versions created at or after this time (inclusive). + + format: date-time + +- `"created_at[lte]": optional string` + + Return versions created at or before this time (inclusive). + + format: date-time + +- `limit: optional number` + + Query parameter for limit + + format: int32 + +- `memory_id: optional string` + + Query parameter for memory_id + +- `operation: optional BetaManagedAgentsMemoryVersionOperation` + + Query parameter for operation + + - `"created"` + + - `"modified"` + + - `"deleted"` + +- `page: optional string` + + Query parameter for page + +- `service_account_id: optional string` + + Query parameter for service_account_id + +- `session_id: optional string` + + Query parameter for session_id + +- `view: optional BetaManagedAgentsMemoryView` + + Query parameter for view + + - `"basic"` + + - `"full"` + +#### Headers + +- `"anthropic-beta": optional array of AnthropicBeta` + + Optional header to specify the beta version(s) you want to use. + + - `string` + + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + + - `"message-batches-2024-09-24"` + + - `"prompt-caching-2024-07-31"` + + - `"computer-use-2024-10-22"` + + - `"computer-use-2025-01-24"` + + - `"pdfs-2024-09-25"` + + - `"token-counting-2024-11-01"` + + - `"token-efficient-tools-2025-02-19"` + + - `"output-128k-2025-02-19"` + + - `"files-api-2025-04-14"` + + - `"mcp-client-2025-04-04"` + + - `"mcp-client-2025-11-20"` + + - `"dev-full-thinking-2025-05-14"` + + - `"interleaved-thinking-2025-05-14"` + + - `"code-execution-2025-05-22"` + + - `"extended-cache-ttl-2025-04-11"` + + - `"context-1m-2025-08-07"` + + - `"context-management-2025-06-27"` + + - `"model-context-window-exceeded-2025-08-26"` + + - `"skills-2025-10-02"` + + - `"fast-mode-2026-02-01"` + + - `"output-300k-2026-03-24"` + + - `"user-profiles-2026-03-24"` + + - `"user-profiles-2026-08-18"` + + - `"advisor-tool-2026-03-01"` + + - `"managed-agents-2026-04-01"` + + - `"cache-diagnosis-2026-04-07"` + + - `"dreaming-2026-04-21"` + + - `"thinking-token-count-2026-05-13"` + + - `"server-side-fallback-2026-06-01"` + + - `"server-side-fallback-2026-07-01"` + + - `"fallback-credit-2026-06-01"` + + - `"fallback-credit-2026-07-01"` + + - `"agent-memory-2026-07-22"` + + - `"mid-conversation-tool-changes-2026-07-01"` + +#### Returns + +- `data: optional array of BetaManagedAgentsMemoryVersion` + + One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak. - `id: string` - ID of the deleted memory (a `mem_...` value). - - - `type: "memory_deleted"` - - - `"memory_deleted"` - -### Beta Managed Agents Error - -- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more` - - - `BetaInvalidRequestError object { message, type }` - - - `message: string` - - - `type: "invalid_request_error"` - - - `"invalid_request_error"` - - - `BetaAuthenticationError object { message, type }` - - - `message: string` - - - `type: "authentication_error"` - - - `"authentication_error"` - - - `BetaBillingError object { message, type }` - - - `message: string` - - - `type: "billing_error"` - - - `"billing_error"` - - - `BetaPermissionError object { message, type }` - - - `message: string` - - - `type: "permission_error"` - - - `"permission_error"` - - - `BetaNotFoundError object { message, type }` - - - `message: string` - - - `type: "not_found_error"` - - - `"not_found_error"` - - - `BetaRateLimitError object { message, type }` - - - `message: string` - - - `type: "rate_limit_error"` - - - `"rate_limit_error"` - - - `BetaGatewayTimeoutError object { message, type }` - - - `message: string` - - - `type: "timeout_error"` - - - `"timeout_error"` - - - `BetaAPIError object { message, type }` - - - `message: string` - - - `type: "api_error"` - - - `"api_error"` - - - `BetaOverloadedError object { message, type }` - - - `message: string` - - - `type: "overloaded_error"` - - - `"overloaded_error"` - - - `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }` - - - `type: "memory_precondition_failed_error"` - - - `"memory_precondition_failed_error"` - - - `message: optional string` - - - `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }` - - - `type: "memory_path_conflict_error"` - - - `"memory_path_conflict_error"` - - - `conflicting_memory_id: optional string` - - - `conflicting_path: optional string` - - - `message: optional string` - - - `BetaManagedAgentsConflictError object { type, message }` - - - `type: "conflict_error"` - - - `"conflict_error"` - - - `message: optional string` - -### Beta Managed Agents Memory - -- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` - - A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update. - - - `id: string` - - Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory. - - - `content_sha256: string` - - Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`. - - - `content_size_bytes: number` - - Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. + Unique identifier for this version (a `memver_...` value). - `created_at: string` A timestamp in RFC 3339 format + format: date-time + + - `memory_id: string` + + ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. + - `memory_store_id: string` - ID of the memory store this memory belongs to (a `memstore_...` value). - - - `memory_version_id: string` - - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - - - `path: string` - - Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes. - - - `type: "memory"` - - - `"memory"` - - - `updated_at: string` - - A timestamp in RFC 3339 format + ID of the memory store this version belongs to (a `memstore_...` value). + + - `operation: BetaManagedAgentsMemoryVersionOperation` + + The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values. + + - `"created"` + + - `"modified"` + + - `"deleted"` + + - `type: "memory_version"` - `content: optional string or null` - The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). - -### Beta Managed Agents Memory List Item - -- `BetaManagedAgentsMemoryListItem = BetaManagedAgentsMemory or BetaManagedAgentsMemoryPrefix` - - One item in a [List memories](/docs/en/api/beta/memory_stores/memories/list) response: either a `memory` object or, when `depth` is set, a `memory_prefix` rollup marker. - - - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }` - - A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update. - - - `id: string` - - Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory. - - - `content_sha256: string` - - Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`. - - - `content_size_bytes: number` - - Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. - - - `created_at: string` - - A timestamp in RFC 3339 format - - - `memory_store_id: string` - - ID of the memory store this memory belongs to (a `memstore_...` value). - - - `memory_version_id: string` - - ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list). - - - `path: string` - - Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes. - - - `type: "memory"` - - - `"memory"` - - - `updated_at: string` - - A timestamp in RFC 3339 format - - - `content: optional string or null` - - The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). - - - `BetaManagedAgentsMemoryPrefix object { path, type }` - - A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order. - - - `path: string` - - The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory. - - - `type: "memory_prefix"` - - - `"memory_prefix"` - -### Beta Managed Agents Memory Path Conflict Error - -- `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }` - - - `type: "memory_path_conflict_error"` - - - `"memory_path_conflict_error"` - - - `conflicting_memory_id: optional string` - - - `conflicting_path: optional string` - - - `message: optional string` - -### Beta Managed Agents Memory Precondition Failed Error - -- `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }` - - - `type: "memory_precondition_failed_error"` - - - `"memory_precondition_failed_error"` - - - `message: optional string` - -### Beta Managed Agents Memory Prefix - -- `BetaManagedAgentsMemoryPrefix object { path, type }` - - A rolled-up directory marker returned by [List memories](/docs/en/api/beta/memory_stores/memories/list) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order. - - - `path: string` - - The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory. - - - `type: "memory_prefix"` - - - `"memory_prefix"` - -### Beta Managed Agents Memory View - -- `BetaManagedAgentsMemoryView = "basic" or "full"` - - Selects which projection of a `memory` or `memory_version` the server returns. `basic` returns the object with `content` set to `null`; `full` populates `content`. When omitted, the default is endpoint-specific: retrieve operations default to `full`; list, create, and update operations default to `basic`. Listing with `view=full` caps `limit` at 20. - - - `"basic"` - - - `"full"` - -### Beta Managed Agents Precondition - -- `BetaManagedAgentsPrecondition object { type, content_sha256 }` - - Optimistic-concurrency precondition: the update applies only if the memory's stored `content_sha256` equals the supplied value. On mismatch, the request returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and retry against the fresh state. If the precondition fails but the stored state already exactly matches the requested `content` and `path`, the server returns 200 instead of 409. - - - `type: "content_sha256"` - - - `"content_sha256"` - - - `content_sha256: optional string` - - Expected `content_sha256` of the stored memory (64 lowercase hexadecimal characters). Typically the `content_sha256` returned by a prior read or list call. Because the server applies no content normalization, clients can also compute this locally as the SHA-256 of the UTF-8 content bytes. - -# Memory Versions - -## List memory versions - -**get** `/v1/memory_stores/{memory_store_id}/memory_versions` - -List memory versions - -### Path Parameters - -- `memory_store_id: string` - -### Query Parameters - -- `api_key_id: optional string` - - Query parameter for api_key_id - -- `"created_at[gte]": optional string` - - Return versions created at or after this time (inclusive). - -- `"created_at[lte]": optional string` - - Return versions created at or before this time (inclusive). - -- `limit: optional number` - - Query parameter for limit - -- `memory_id: optional string` - - Query parameter for memory_id - -- `operation: optional BetaManagedAgentsMemoryVersionOperation` - - Query parameter for operation - - - `"created"` - - - `"modified"` - - - `"deleted"` - -- `page: optional string` - - Query parameter for page - -- `service_account_id: optional string` - - Query parameter for service_account_id - -- `session_id: optional string` - - Query parameter for session_id - -- `view: optional BetaManagedAgentsMemoryView` - - Query parameter for view - - - `"basic"` - - - `"full"` - -### Header Parameters - -- `"anthropic-beta": optional array of AnthropicBeta` - - Optional header to specify the beta version(s) you want to use. - - - `string` - - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - - - `"message-batches-2024-09-24"` - - - `"prompt-caching-2024-07-31"` - - - `"computer-use-2024-10-22"` - - - `"computer-use-2025-01-24"` - - - `"pdfs-2024-09-25"` - - - `"token-counting-2024-11-01"` - - - `"token-efficient-tools-2025-02-19"` - - - `"output-128k-2025-02-19"` - - - `"files-api-2025-04-14"` - - - `"mcp-client-2025-04-04"` - - - `"mcp-client-2025-11-20"` - - - `"dev-full-thinking-2025-05-14"` - - - `"interleaved-thinking-2025-05-14"` - - - `"code-execution-2025-05-22"` - - - `"extended-cache-ttl-2025-04-11"` - - - `"context-1m-2025-08-07"` - - - `"context-management-2025-06-27"` - - - `"model-context-window-exceeded-2025-08-26"` - - - `"skills-2025-10-02"` - - - `"fast-mode-2026-02-01"` - - - `"output-300k-2026-03-24"` - - - `"user-profiles-2026-03-24"` - - - `"user-profiles-2026-08-18"` - - - `"advisor-tool-2026-03-01"` - - - `"managed-agents-2026-04-01"` - - - `"cache-diagnosis-2026-04-07"` - - - `"dreaming-2026-04-21"` - - - `"thinking-token-count-2026-05-13"` - - - `"server-side-fallback-2026-06-01"` - - - `"server-side-fallback-2026-07-01"` - - - `"fallback-credit-2026-06-01"` - - - `"fallback-credit-2026-07-01"` - - - `"agent-memory-2026-07-22"` - - - `"mid-conversation-tool-changes-2026-07-01"` - -### Returns - -- `data: optional array of BetaManagedAgentsMemoryVersion` - - One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak. - - - `id: string` - - Unique identifier for this version (a `memver_...` value). - - - `created_at: string` - - A timestamp in RFC 3339 format - - - `memory_id: string` - - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. - - - `memory_store_id: string` - - ID of the memory store this version belongs to (a `memstore_...` value). - - - `operation: BetaManagedAgentsMemoryVersionOperation` - - The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values. - - - `"created"` - - - `"modified"` - - - `"deleted"` - - - `type: "memory_version"` - - - `"memory_version"` - - - `content: optional string or null` - The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set. - `content_sha256: optional string or null`
Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. + format: int32 + - `created_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - `BetaManagedAgentsSessionActor object { session_id, type }` + - `BetaManagedAgentsSessionActor object` Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. + minLength: 1 + - `type: "session_actor"` - - `"session_actor"` - - - `BetaManagedAgentsAPIActor object { api_key_id, type }` + - `BetaManagedAgentsAPIActor object` Attribution for a write made directly via the public API (outside of any session).
ID of the API key that performed the write. This identifies the key, not the secret. + minLength: 1 + - `type: "api_actor"` - - `"api_actor"` - - - `BetaManagedAgentsUserActor object { type, user_id }` + - `BetaManagedAgentsUserActor object` Attribution for a write made by a human user through the Anthropic Console. - `type: "user_actor"` - - `"user_actor"` - - `user_id: string` ID of the user who performed the write (a `user_...` value). - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + minLength: 1 + + - `BetaManagedAgentsServiceAccountActor object` Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
ID of the service account that performed the write (a `svac_...` value). + minLength: 1 + - `type: "service_account_actor"` - - `"service_account_actor"` - - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
A timestamp in RFC 3339 format + format: date-time + - `redacted_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request. -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} ``` -## Retrieve a memory version - -**get** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}` +### Retrieve a memory version + +**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}` Retrieve a memory version -### Path Parameters +#### Path parameters - `memory_store_id: string` - `memory_version_id: string` -### Query Parameters +#### Query parameters - `view: optional BetaManagedAgentsMemoryView`
- `"full"` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns - -- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }` +#### Returns + +- `BetaManagedAgentsMemoryVersion object` A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
A timestamp in RFC 3339 format + format: date-time + - `memory_id: string` ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
- `type: "memory_version"` - - `"memory_version"` - - `content: optional string or null` The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. + format: int32 + - `created_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - `BetaManagedAgentsSessionActor object { session_id, type }` + - `BetaManagedAgentsSessionActor object` Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. + minLength: 1 + - `type: "session_actor"` - - `"session_actor"` - - - `BetaManagedAgentsAPIActor object { api_key_id, type }` + - `BetaManagedAgentsAPIActor object` Attribution for a write made directly via the public API (outside of any session).
ID of the API key that performed the write. This identifies the key, not the secret. + minLength: 1 + - `type: "api_actor"` - - `"api_actor"` - - - `BetaManagedAgentsUserActor object { type, user_id }` + - `BetaManagedAgentsUserActor object` Attribution for a write made by a human user through the Anthropic Console. - `type: "user_actor"` - - `"user_actor"` - - `user_id: string` ID of the user who performed the write (a `user_...` value). - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + minLength: 1 + + - `BetaManagedAgentsServiceAccountActor object` Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
ID of the service account that performed the write (a `svac_...` value). + minLength: 1 + - `type: "service_account_actor"` - - `"service_account_actor"` - - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
A timestamp in RFC 3339 format + format: date-time + - `redacted_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: agent-memory-2026-07-22' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} ``` -## Redact a memory version - -**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact` +### Redact a memory version + +**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact` Redact a memory version -### Path Parameters +#### Path parameters - `memory_store_id: string` - `memory_version_id: string` -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns - -- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }` +#### Returns + +- `BetaManagedAgentsMemoryVersion object` A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
A timestamp in RFC 3339 format + format: date-time + - `memory_id: string` ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
- `type: "memory_version"` - - `"memory_version"` - - `content: optional string or null` The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. + format: int32 + - `created_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - `BetaManagedAgentsSessionActor object { session_id, type }` + - `BetaManagedAgentsSessionActor object` Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. + minLength: 1 + - `type: "session_actor"` - - `"session_actor"` - - - `BetaManagedAgentsAPIActor object { api_key_id, type }` + - `BetaManagedAgentsAPIActor object` Attribution for a write made directly via the public API (outside of any session).
ID of the API key that performed the write. This identifies the key, not the secret. + minLength: 1 + - `type: "api_actor"` - - `"api_actor"` - - - `BetaManagedAgentsUserActor object { type, user_id }` + - `BetaManagedAgentsUserActor object` Attribution for a write made by a human user through the Anthropic Console. - `type: "user_actor"` - - `"user_actor"` - - `user_id: string` ID of the user who performed the write (a `user_...` value). - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + minLength: 1 + + - `BetaManagedAgentsServiceAccountActor object` Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
ID of the service account that performed the write (a `svac_...` value). + minLength: 1 + - `type: "service_account_actor"` - - `"service_account_actor"` - - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
A timestamp in RFC 3339 format + format: date-time + - `redacted_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). -### Example - -```http +#### Example + +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \ -X POST \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
} } ``` - -## Domain Types - -### Beta Managed Agents Actor - -- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor` - - Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - - `BetaManagedAgentsSessionActor object { session_id, type }` - - Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`. - - - `session_id: string` - - ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. - - - `type: "session_actor"` - - - `"session_actor"` - - - `BetaManagedAgentsAPIActor object { api_key_id, type }` - - Attribution for a write made directly via the public API (outside of any session). - - - `api_key_id: string` - - ID of the API key that performed the write. This identifies the key, not the secret. - - - `type: "api_actor"` - - - `"api_actor"` - - - `BetaManagedAgentsUserActor object { type, user_id }` - - Attribution for a write made by a human user through the Anthropic Console. - - - `type: "user_actor"` - - - `"user_actor"` - - - `user_id: string` - - ID of the user who performed the write (a `user_...` value). - - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` - - Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. - - - `service_account_id: string` - - ID of the service account that performed the write (a `svac_...` value). - - - `type: "service_account_actor"` - - - `"service_account_actor"` - -### Beta Managed Agents API Actor - -- `BetaManagedAgentsAPIActor object { api_key_id, type }` - - Attribution for a write made directly via the public API (outside of any session). - - - `api_key_id: string` - - ID of the API key that performed the write. This identifies the key, not the secret. - - - `type: "api_actor"` - - - `"api_actor"` - -### Beta Managed Agents Memory Version - -- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }` - - A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. - - - `id: string` - - Unique identifier for this version (a `memver_...` value). - - - `created_at: string` - - A timestamp in RFC 3339 format - - - `memory_id: string` - - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. - - - `memory_store_id: string` - - ID of the memory store this version belongs to (a `memstore_...` value). - - - `operation: BetaManagedAgentsMemoryVersionOperation` - - The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values. - - - `"created"` - - - `"modified"` - - - `"deleted"` - - - `type: "memory_version"` - - - `"memory_version"` - - - `content: optional string or null` - - The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set. - - - `content_sha256: optional string or null` - - Lowercase hex SHA-256 digest of `content` as of this version (64 characters). `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - - - `content_size_bytes: optional number or null` - - Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - - - `created_by: optional BetaManagedAgentsActor` - - Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - - `BetaManagedAgentsSessionActor object { session_id, type }` - - Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`. - - - `session_id: string` - - ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. - - - `type: "session_actor"` - - - `"session_actor"` - - - `BetaManagedAgentsAPIActor object { api_key_id, type }` - - Attribution for a write made directly via the public API (outside of any session). - - - `api_key_id: string` - - ID of the API key that performed the write. This identifies the key, not the secret. - - - `type: "api_actor"` - - - `"api_actor"` - - - `BetaManagedAgentsUserActor object { type, user_id }` - - Attribution for a write made by a human user through the Anthropic Console. - - - `type: "user_actor"` - - - `"user_actor"` - - - `user_id: string` - - ID of the user who performed the write (a `user_...` value). - - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` - - Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. - - - `service_account_id: string` - - ID of the service account that performed the write (a `svac_...` value). - - - `type: "service_account_actor"` - - - `"service_account_actor"` - - - `path: optional string or null` - - The memory's path at the time of this write. `null` if and only if `redacted_at` is set. - - - `redacted_at: optional string or null` - - A timestamp in RFC 3339 format - - - `redacted_by: optional BetaManagedAgentsActor` - - Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - -### Beta Managed Agents Memory Version Operation - -- `BetaManagedAgentsMemoryVersionOperation = "created" or "modified" or "deleted"` - - The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values. - - - `"created"` - - - `"modified"` - - - `"deleted"` - -### Beta Managed Agents Service Account Actor - -- `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` - - Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. - - - `service_account_id: string` - - ID of the service account that performed the write (a `svac_...` value). - - - `type: "service_account_actor"` - - - `"service_account_actor"` - -### Beta Managed Agents Session Actor - -- `BetaManagedAgentsSessionActor object { session_id, type }` - - Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`. - - - `session_id: string` - - ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. - - - `type: "session_actor"` - - - `"session_actor"` - -### Beta Managed Agents User Actor - -- `BetaManagedAgentsUserActor object { type, user_id }` - - Attribution for a write made by a human user through the Anthropic Console. - - - `type: "user_actor"` - - - `"user_actor"` - - - `user_id: string` - - ID of the user who performed the write (a `user_...` value).
api/beta/memory_stores Changed · +121 / -15 lines
### Beta Managed Agents Service Account Actor
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
Query parameter for page +- `service_account_id: optional string` + + Query parameter for service_account_id + - `session_id: optional string` Query parameter for session_id
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
ID of the user who performed the write (a `user_...` value). + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` + - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
ID of the user who performed the write (a `user_...` value). + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` + - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
ID of the user who performed the write (a `user_...` value). + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` + - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
### Beta Managed Agents Actor -- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor` +- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
ID of the user who performed the write (a `user_...` value). + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` + ### Beta Managed Agents API Actor - `BetaManagedAgentsAPIActor object { api_key_id, type }`
ID of the user who performed the write (a `user_...` value). + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` + - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
- `"modified"` - `"deleted"` + +### Beta Managed Agents Service Account Actor + +- `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` ### Beta Managed Agents Session Actor
api/beta/memory_stores First recorded · 3121 lines, first recorded
# Memory Stores ## Create a memory store ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## List memory stores ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Retrieve a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Update a memory store ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## Delete a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Archive a memory store ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Deleted Memory Store ### Beta Managed Agents Memory Store # Memories ## Create a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## List memories ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Retrieve a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Update a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## Delete a memory ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Conflict Error ### Beta Managed Agents Content Sha256 Precondition ### Beta Managed Agents Deleted Memory ### Beta Managed Agents Error ### Beta Managed Agents Memory ### Beta Managed Agents Memory List Item ### Beta Managed Agents Memory Path Conflict Error ### Beta Managed Agents Memory Precondition Failed Error ### Beta Managed Agents Memory Prefix ### Beta Managed Agents Memory View ### Beta Managed Agents Precondition # Memory Versions ## List memory versions ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Retrieve a memory version ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Redact a memory version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Actor ### Beta Managed Agents API Actor ### Beta Managed Agents Memory Version ### Beta Managed Agents Memory Version Operation ### Beta Managed Agents Session Actor ### Beta Managed Agents User Actor
The first capture of this source. The page was already there, and this is what it said.
---
title: Memory Stores
url: https://platform.claude.com/docs/en/api/beta/memory_stores
---
# Memory Stores
## Create a memory store
**post** `/v1/memory_stores`
Create a memory store
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `name: string`
Human-readable name for the store. Required; 1–255 characters; no control characters. The mount-path slug under `/mnt/memory/` is derived from this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need not be unique within a workspace.
- `description: optional string`
Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent.
- `metadata: optional map[string]`
Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Not visible to the agent.
### Returns
- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
A `memory_store`: a named container for agent memories, scoped to a workspace. Attach a store to a session via `resources[]` to mount it as a directory the agent can read and write.
- `id: string`
Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
- `created_at: string`
A timestamp in RFC 3339 format
- `name: string`
Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
- `type: "memory_store"`
- `"memory_store"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `archived_at: optional string or null`
A timestamp in RFC 3339 format
- `description: optional string`
Free-text description of what the store contains, up to 1024 characters. Included in the agent's system prompt when the store is attached, so word it to be useful to the agent. Empty string when unset.
- `metadata: optional map[string]`
Arbitrary key-value tags for your own bookkeeping (such as the end user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters. Returned on retrieve/list but not filterable.
### Example
```http
curl https://api.anthropic.com/v1/memory_stores \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: agent-memory-2026-07-22' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-d '{
"name": "x"
}'
```
#### Response
```json
{
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"name": "name",
"type": "memory_store",
"updated_at": "2019-12-27T18:11:19.117Z",
"archived_at": "2019-12-27T18:11:19.117Z",
"description": "description",
"metadata": {
"foo": "string"
}
}
```
## List memory stores
**get** `/v1/memory_stores`
List memory stores
### Query Parameters
- `"created_at[gte]": optional string`
Return only stores whose `created_at` is at or after this time (inclusive). Sent on the wire as `created_at[gte]`.
- `"created_at[lte]": optional string`
Return only stores whose `created_at` is at or before this time (inclusive). Sent on the wire as `created_at[lte]`.
- `include_archived: optional boolean`
When `true`, archived stores are included in the results. Defaults to `false` (archived stores are excluded).
- `limit: optional number`
Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted.
- `page: optional string`
Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsMemoryStore`
Memory stores on this page, newest first. Empty when there are no stores matching the filters.
- `id: string`
Unique identifier for the memory store (a `memstore_...` tagged ID). Use this when attaching the store to a session, or in the `{memory_store_id}` path parameter of subsequent calls.
- `created_at: string`
A timestamp in RFC 3339 format
- `name: string`
Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
- `type: "memory_store"`
- `"memory_store"`
- `updated_at: string`
A timestamp in RFC 3339 format
Cut at 300 lines.