from line 1
1---
2title: Update a memory store
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/update
4---
1# Update a memory store
52
6## Update a memory store
3**POST** `/v1/memory_stores/{memory_store_id}`
74
8**post** `/v1/memory_stores/{memory_store_id}`
9
105Update a memory store
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Body Parameters
89## Body parameters
9590
9691- `description: optional string or null`
9792
9893 New description for the store, up to 1024 characters. Pass an empty string to clear it.
9994
95 maxLength: 1024
96
10097- `metadata: optional map[string] or null`
10198
10299 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.
from line 102
105102
106103 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.
107104
108### Returns
105 minLength: 1, maxLength: 255
109106
110- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`
107## Returns
111108
109- `BetaManagedAgentsMemoryStore object`
110
112111 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.
113112
114113 - `id: string`
from line 118
119118
120119 A timestamp in RFC 3339 format
121120
121 format: date-time
122
122123 - `name: string`
123124
124125 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.
from line 126
125126
126127 - `type: "memory_store"`
127128
128 - `"memory_store"`
129
130129 - `updated_at: string`
131130
132131 A timestamp in RFC 3339 format
133132
133 format: date-time
134
134135 - `archived_at: optional string or null`
135136
136137 A timestamp in RFC 3339 format
137138
139 format: date-time
140
138141 - `description: optional string`
139142
140143 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.
from line 146
143146
144147 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.
145148
146### Example
149## Example
147150
148```http
151```bash
149152curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \
150153 -H 'Content-Type: application/json' \
151154 -H 'anthropic-version: 2023-06-01' \
from line 157
154157 -d '{}'
155158```
156159
157#### Response
160### Response (200)
158161
159162```json
160163{
No line in this hunk matches that.