Update a Memory Store changedapi/beta/memory_stores/update
Nearest release: v2.1.306, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+27added
Lines−13removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
# Update a Memory Store # Update a memory store
The whole hunk
from line 1, old and new numbered
/
from line 1
11---
2title: Update a memory store
2title: Update a Memory Store
33url: https://platform.claude.com/docs/en/api/beta/memory_stores/update
44---
55
6# Update a memory store
6# Update a Memory Store
77
88**POST** `/v1/memory_stores/{memory_store_id}`
99
10Update a memory store
10Update a Memory Store
1111
1212## Path parameters
1313
1414- `memory_store_id: string`
1515
16 ID of the memory store to update (a `memstore_...` identifier). Required. Enumerate IDs via `GET /v1/memory_stores`. Updating an archived store returns 400.
16 The ID of the memory store to update (`memstore_...`).
1717
18 The request fails with HTTP status 400 if the store is archived.
19
1820## Headers
1921
2022- `"anthropic-version": optional string`
from line 143
141143
142144- `description: optional string or null`
143145
144 New description for the store, up to 1024 characters. Pass an empty string to clear it.
146 New description for the store, up to 1,024 characters. Pass an empty string to clear it.
145147
146148 maxLength: 1024
147149
148150- `metadata: optional map[string] or null`
149151
150 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.
152 Changes to apply to the memory store's metadata. Keys you leave out keep their values.
151153
154 Set a key to a string to add or replace it, or to `null` to remove it. After the change, the metadata can hold at most 16 key-value pairs. Keys are 1 to 64 characters long and values at most 512 characters.
155
152156- `name: optional string or null`
153157
154 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.
158 The new name of the memory store, 1 to 255 characters long, without control characters.
155159
160 Sessions created after the change use the new name for the store's directory under `/mnt/memory/`.
161
156162 minLength: 1, maxLength: 255
157163
158164## Returns
from line 171
165171
166172 - `id: string`
167173
168 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.
174 The unique ID of the memory store (`memstore_...`). Use it to attach the store to a session.
169175
170176 - `archived_at: string or null`
171177
172 Timestamp when the store was archived, or `null` if active. Set once and never cleared; archiving is one-way. Archived stores are read-only and cannot be attached to new sessions.
178 When the memory store was archived, in RFC 3339, or `null` if it hasn't been.
173179
180 Archiving can't be undone. An archived store can't be attached to new sessions. You can't create or update its memories or update the store. You can still read and delete its memories, redact their versions, and delete the store.
181
182 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#archive-a-store) to learn more about archiving.
183
174184 format: date-time
175185
176186 - `created_at: string`
177187
178 Timestamp when the store was created.
188 When the memory store was created, in RFC 3339.
179189
180190 format: date-time
181191
182192 - `description: string`
183193
184 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.
194 Free-text description of what the store contains, up to 1,024 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.
185195
186196 - `metadata: map[string]`
187197
188 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.
198 Key-value pairs for your own use, such as the end user that the store belongs to.
189199
200 A store has at most 16 pairs. Keys are 1 to 64 characters long and values at most 512 characters. You can't filter lists by metadata.
201
190202 - `name: string`
191203
192204 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 205
193205
194206 - `updated_at: string`
195207
196 Timestamp when the store's `name`, `description`, or `metadata` was last modified. Memory writes inside the store do not advance this.
208 When the memory store was last changed, in RFC 3339.
209
210 Changing its `name`, `description`, or `metadata` updates it. Archiving the store does too. Changes to the store's memories don't.
197211
198212 format: date-time
199213
No line in this hunk matches that.