Home Docs Claude Developer Platform 25 Aug 2026

One change · api

Memory Stores changedapi/beta/memory_stores

Nearest release: v2.1.245, published an hour 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 25 Aug 2026 03:37 UTC

Lines+444added

Lines−929removed

From line 1 where the diff opens

First seen 14 Aug 2026 this site's first read of the page

Recorded edits22to this page, all time

### 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 whole hunk

from line 1, old and new numbered

lines

The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.

from line 1

1---

2title: Memory Stores

3url: https://platform.claude.com/docs/en/api/beta/memory_stores

4---

61# Memory Stores

83## Create a memory store

10**post** `/v1/memory_stores`

5**POST** `/v1/memory_stores`

116

127Create a memory store

138

14### Header Parameters

9### Headers

1510

1611- `"anthropic-beta": optional array of AnthropicBeta`

1712

from line 84

8984

9085 - `"mid-conversation-tool-changes-2026-07-01"`

9186

92### Body Parameters

87### Body parameters

9388

9489- `name: string`

9590

9691 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.

9792

93 minLength: 1, maxLength: 255

9895- `description: optional string`

9996

10097 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.

10198

99 maxLength: 1024

100

102101- `metadata: optional map[string]`

103102

104103 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.

105104

106105### Returns

107106

108- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`

107- `BetaManagedAgentsMemoryStore object`

109108

110109 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.

111110

from line 116

117116

118117 A timestamp in RFC 3339 format

119118

119 format: date-time

120

120121 - `name: string`

121122

122123 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

123124

124125 - `type: "memory_store"`

125126

126 - `"memory_store"`

127

128127 - `updated_at: string`

129128

130129 A timestamp in RFC 3339 format

131130

131 format: date-time

132

132133 - `archived_at: optional string or null`

133134

134135 A timestamp in RFC 3339 format

135136

137 format: date-time

138

136139 - `description: optional string`

137140

138141 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### Example

145148

146```http

149```bash

147150curl https://api.anthropic.com/v1/memory_stores \

148151 -H 'Content-Type: application/json' \

149152 -H 'anthropic-version: 2023-06-01' \

from line 157

154157 }'

155158```

156159

157#### Response

160#### Response (200)

158161

159162```json

160163{

from line 176

173176

174177## List memory stores

175178

176**get** `/v1/memory_stores`

179**GET** `/v1/memory_stores`

177180

178181List memory stores

179182

180### Query Parameters

183### Query parameters

181184

182185- `"created_at[gte]": optional string`

183186

184187 Return only stores whose `created_at` is at or after this time (inclusive). Sent on the wire as `created_at[gte]`.

185188

189 format: date-time

190

186191- `"created_at[lte]": optional string`

187192

188193 Return only stores whose `created_at` is at or before this time (inclusive). Sent on the wire as `created_at[lte]`.

189194

195 format: date-time

196

190197- `include_archived: optional boolean`

191198

192199 When `true`, archived stores are included in the results. Defaults to `false` (archived stores are excluded).

from line 202

195202

196203 Maximum number of stores to return per page. Must be between 1 and 100. Defaults to 20 when omitted.

197204

205 format: int32

206

198207- `page: optional string`

199208

200209 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.

201210

202### Header Parameters

211### Headers

203212

204213- `"anthropic-beta": optional array of AnthropicBeta`

205214

from line 300

291300

292301 A timestamp in RFC 3339 format

293302

303 format: date-time

304

294305 - `name: string`

295306

296307 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

297308

298309 - `type: "memory_store"`

299310

300 - `"memory_store"`

301

302311 - `updated_at: string`

303312

304313 A timestamp in RFC 3339 format

305314

315 format: date-time

316

306317 - `archived_at: optional string or null`

307318

308319 A timestamp in RFC 3339 format

309320

321 format: date-time

322

310323 - `description: optional string`

311324

312325 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 334

321334

322335### Example

323336

324```http

337```bash

325338curl https://api.anthropic.com/v1/memory_stores \

326339 -H 'anthropic-version: 2023-06-01' \

327340 -H 'anthropic-beta: agent-memory-2026-07-22' \

328341 -H "X-Api-Key: $ANTHROPIC_API_KEY"

329342```

330343

331#### Response

344#### Response (200)

332345

333346```json

334347{

from line 365

352365

353366## Retrieve a memory store

354367

355**get** `/v1/memory_stores/{memory_store_id}`

368**GET** `/v1/memory_stores/{memory_store_id}`

356369

357370Retrieve a memory store

358371

359### Path Parameters

372### Path parameters

360373

361374- `memory_store_id: string`

362375

363### Header Parameters

376### Headers

364377

365378- `"anthropic-beta": optional array of AnthropicBeta`

366379

from line 453

440453

441454### Returns

442455

443- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`

456- `BetaManagedAgentsMemoryStore object`

444457

445458 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.

446459

from line 465

452465

453466 A timestamp in RFC 3339 format

454467

468 format: date-time

469

455470 - `name: string`

456471

457472 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

458473

459474 - `type: "memory_store"`

460475

461 - `"memory_store"`

462

463476 - `updated_at: string`

464477

465478 A timestamp in RFC 3339 format

466479

480 format: date-time

481

467482 - `archived_at: optional string or null`

468483

469484 A timestamp in RFC 3339 format

470485

486 format: date-time

487

471488 - `description: optional string`

472489

473490 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 495

478495

479496### Example

480497

481```http

498```bash

482499curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \

483500 -H 'anthropic-version: 2023-06-01' \

484501 -H 'anthropic-beta: agent-memory-2026-07-22' \

485502 -H "X-Api-Key: $ANTHROPIC_API_KEY"

486503```

487504

488#### Response

505#### Response (200)

489506

490507```json

491508{

from line 521

504521

505522## Update a memory store

506523

507**post** `/v1/memory_stores/{memory_store_id}`

524**POST** `/v1/memory_stores/{memory_store_id}`

508525

509526Update a memory store

510527

511### Path Parameters

528### Path parameters

512529

513530- `memory_store_id: string`

514531

515### Header Parameters

532### Headers

516533

517534- `"anthropic-beta": optional array of AnthropicBeta`

518535

from line 607

590607

591608 - `"mid-conversation-tool-changes-2026-07-01"`

592609

593### Body Parameters

610### Body parameters

594611

595612- `description: optional string or null`

596613

597614 New description for the store, up to 1024 characters. Pass an empty string to clear it.

598615

616 maxLength: 1024

617

599618- `metadata: optional map[string] or null`

600619

601620 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 623

604623

605624 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.

606625

626 minLength: 1, maxLength: 255

627

607628### Returns

608629

609- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`

630- `BetaManagedAgentsMemoryStore object`

610631

611632 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.

612633

from line 639

618639

619640 A timestamp in RFC 3339 format

620641

642 format: date-time

643

621644 - `name: string`

622645

623646 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

624647

625648 - `type: "memory_store"`

626649

627 - `"memory_store"`

628

629650 - `updated_at: string`

630651

631652 A timestamp in RFC 3339 format

632653

654 format: date-time

655

633656 - `archived_at: optional string or null`

634657

635658 A timestamp in RFC 3339 format

636659

660 format: date-time

661

637662 - `description: optional string`

638663

639664 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 669

644669

645670### Example

646671

647```http

672```bash

648673curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \

649674 -H 'Content-Type: application/json' \

650675 -H 'anthropic-version: 2023-06-01' \

from line 678

653678 -d '{}'

654679```

655680

656#### Response

681#### Response (200)

657682

658683```json

659684{

from line 697

672697

673698## Delete a memory store

674699

675**delete** `/v1/memory_stores/{memory_store_id}`

700**DELETE** `/v1/memory_stores/{memory_store_id}`

676701

677702Delete a memory store

678703

679### Path Parameters

704### Path parameters

680705

681706- `memory_store_id: string`

682707

683### Header Parameters

708### Headers

684709

685710- `"anthropic-beta": optional array of AnthropicBeta`

686711

from line 785

760785

761786### Returns

762787

763- `BetaManagedAgentsDeletedMemoryStore object { id, type }`

788- `BetaManagedAgentsDeletedMemoryStore object`

764789

765790 Confirmation that a `memory_store` was deleted.

766791

from line 795

770795

771796 - `type: "memory_store_deleted"`

772797

773 - `"memory_store_deleted"`

774

775798### Example

776799

777```http

800```bash

778801curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID \

779802 -X DELETE \

780803 -H 'anthropic-version: 2023-06-01' \

from line 805

782805 -H "X-Api-Key: $ANTHROPIC_API_KEY"

783806```

784807

785#### Response

808#### Response (200)

786809

787810```json

788811{

from line 816

793816

794817## Archive a memory store

795818

796**post** `/v1/memory_stores/{memory_store_id}/archive`

819**POST** `/v1/memory_stores/{memory_store_id}/archive`

797820

798821Archive a memory store

799822

800### Path Parameters

823### Path parameters

801824

802825- `memory_store_id: string`

803826

804### Header Parameters

827### Headers

805828

806829- `"anthropic-beta": optional array of AnthropicBeta`

807830

from line 904

881904

882905### Returns

883906

884- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`

907- `BetaManagedAgentsMemoryStore object`

885908

886909 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.

887910

from line 916

893916

894917 A timestamp in RFC 3339 format

895918

919 format: date-time

920

896921 - `name: string`

897922

898923 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

899924

900925 - `type: "memory_store"`

901926

902 - `"memory_store"`

903

904927 - `updated_at: string`

905928

906929 A timestamp in RFC 3339 format

907930

931 format: date-time

932

908933 - `archived_at: optional string or null`

909934

910935 A timestamp in RFC 3339 format

911936

937 format: date-time

938

912939 - `description: optional string`

913940

914941 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 946

919946

920947### Example

921948

922```http

949```bash

923950curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/archive \

924951 -X POST \

925952 -H 'anthropic-version: 2023-06-01' \

from line 954

927954 -H "X-Api-Key: $ANTHROPIC_API_KEY"

928955```

929956

930#### Response

957#### Response (200)

931958

932959```json

933960{

from line 971

944971}

945972```

946973

947## Domain Types

974## Domain types

948975

949976### Beta Managed Agents Deleted Memory Store

950977

951- `BetaManagedAgentsDeletedMemoryStore object { id, type }`

978- `BetaManagedAgentsDeletedMemoryStore object`

952979

953980 Confirmation that a `memory_store` was deleted.

954981

from line 985

958985

959986 - `type: "memory_store_deleted"`

960987

961 - `"memory_store_deleted"`

962

963988### Beta Managed Agents Memory Store

964989

965- `BetaManagedAgentsMemoryStore object { id, created_at, name, 5 more }`

990- `BetaManagedAgentsMemoryStore object`

966991

967992 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.

968993

from line 999

974999

9751000 A timestamp in RFC 3339 format

9761001

1002 format: date-time

1003

9771004 - `name: string`

9781005

9791006 Human-readable name for the store. 1–255 characters. The store's mount-path slug under `/mnt/memory/` is derived from this name.

9801007

9811008 - `type: "memory_store"`

9821009

983 - `"memory_store"`

984

9851010 - `updated_at: string`

9861011

9871012 A timestamp in RFC 3339 format

9881013

1014 format: date-time

1015

9891016 - `archived_at: optional string or null`

9901017

9911018 A timestamp in RFC 3339 format

9921019

1020 format: date-time

1021

9931022 - `description: optional string`

9941023

9951024 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 1027

9981027

9991028 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.

10001029

1001# Memories

1002

1003## Create a memory

1004

1005**post** `/v1/memory_stores/{memory_store_id}/memories`

1030## Memory Stores › Memories

1031

1032### Create a memory

1033

1034**POST** `/v1/memory_stores/{memory_store_id}/memories`

10061035

10071036Create a memory

10081037

1009### Path Parameters

1038#### Path parameters

10101039

10111040- `memory_store_id: string`

10121041

1013### Query Parameters

1042#### Query parameters

10141043

10151044- `view: optional BetaManagedAgentsMemoryView`

10161045

from line 1049

10201049

10211050 - `"full"`

10221051

1023### Header Parameters

1052#### Headers

10241053

10251054- `"anthropic-beta": optional array of AnthropicBeta`

10261055

from line 1127

10981127

10991128 - `"mid-conversation-tool-changes-2026-07-01"`

11001129

1101### Body Parameters

1130#### Body parameters

11021131

11031132- `content: string or null`

11041133

from line 1137

11081137

11091138 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.

11101139

1111### Returns

1112

1113- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

1140 minLength: 2, maxLength: 1024

1141

1142#### Returns

1143

1144- `BetaManagedAgentsMemory object`

11141145

11151146 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.

11161147

from line 1157

11261157

11271158 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

11281159

1160 format: int32

1161

11291162 - `created_at: string`

11301163

11311164 A timestamp in RFC 3339 format

11321165

1166 format: date-time

1167

11331168 - `memory_store_id: string`

11341169

11351170 ID of the memory store this memory belongs to (a `memstore_...` value).

from line 1179

11441179

11451180 - `type: "memory"`

11461181

1147 - `"memory"`

1148

11491182 - `updated_at: string`

11501183

11511184 A timestamp in RFC 3339 format

11521185

1186 format: date-time

1187

11531188 - `content: optional string or null`

11541189

11551190 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

11561191

1157### Example

1158

1159```http

1192#### Example

1193

1194```bash

11601195curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \

11611196 -H 'Content-Type: application/json' \

11621197 -H 'anthropic-version: 2023-06-01' \

from line 1203

11681203 }'

11691204```

11701205

1171#### Response

1206##### Response (200)

11721207

11731208```json

11741209{

from line 1220

11851220}

11861221```

11871222

1188## List memories

1189

1190**get** `/v1/memory_stores/{memory_store_id}/memories`

1223### List memories

1224

1225**GET** `/v1/memory_stores/{memory_store_id}/memories`

11911226

11921227List memories

11931228

1194### Path Parameters

1229#### Path parameters

11951230

11961231- `memory_store_id: string`

11971232

1198### Query Parameters

1233#### Query parameters

11991234

12001235- `depth: optional number`

12011236

12021237 `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`.

12031238

1239 format: int32

1240

12041241- `limit: optional number`

12051242

12061243 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.

12071244

1245 format: int32

1246

12081247- `page: optional string`

12091248

12101249 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.

from line 1260

12211260

12221261 - `"full"`

12231262

1224### Header Parameters

1263#### Headers

12251264

12261265- `"anthropic-beta": optional array of AnthropicBeta`

12271266

from line 1338

12991338

13001339 - `"mid-conversation-tool-changes-2026-07-01"`

13011340

1302### Returns

1341#### Returns

13031342

13041343- `data: optional array of BetaManagedAgentsMemoryListItem`

13051344

13061345 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.

13071346

1308 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

1347 - `BetaManagedAgentsMemory object`

13091348

13101349 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.

13111350

from line 1360

13211360

13221361 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

13231362

1363 format: int32

1364

13241365 - `created_at: string`

13251366

13261367 A timestamp in RFC 3339 format

13271368

1369 format: date-time

1370

13281371 - `memory_store_id: string`

13291372

13301373 ID of the memory store this memory belongs to (a `memstore_...` value).

from line 1382

13391382

13401383 - `type: "memory"`

13411384

1342 - `"memory"`

1343

13441385 - `updated_at: string`

13451386

13461387 A timestamp in RFC 3339 format

13471388

1389 format: date-time

1390

13481391 - `content: optional string or null`

13491392

13501393 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

13511394

1352 - `BetaManagedAgentsMemoryPrefix object { path, type }`

1395 - `BetaManagedAgentsMemoryPrefix object`

13531396

13541397 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.

13551398

from line 1402

13591402

13601403 - `type: "memory_prefix"`

13611404

1362 - `"memory_prefix"`

1363

13641405- `next_page: optional string or null`

13651406

13661407 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.

13671408

1368### Example

1369

1370```http

1409#### Example

1410

1411```bash

13711412curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \

13721413 -H 'anthropic-version: 2023-06-01' \

13731414 -H 'anthropic-beta: agent-memory-2026-07-22' \

13741415 -H "X-Api-Key: $ANTHROPIC_API_KEY"

13751416```

13761417

1377#### Response

1418##### Response (200)

13781419

13791420```json

13801421{

from line 1437

13961437}

13971438```

13981439

1399## Retrieve a memory

1400

1401**get** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

1440### Retrieve a memory

1441

1442**GET** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

14021443

14031444Retrieve a memory

14041445

1405### Path Parameters

1446#### Path parameters

14061447

14071448- `memory_store_id: string`

14081449

14091450- `memory_id: string`

14101451

1411### Query Parameters

1452#### Query parameters

14121453

14131454- `view: optional BetaManagedAgentsMemoryView`

14141455

from line 1459

14181459

14191460 - `"full"`

14201461

1421### Header Parameters

1462#### Headers

14221463

14231464- `"anthropic-beta": optional array of AnthropicBeta`

14241465

from line 1537

14961537

14971538 - `"mid-conversation-tool-changes-2026-07-01"`

14981539

1499### Returns

1500

1501- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

1540#### Returns

1541

1542- `BetaManagedAgentsMemory object`

15021543

15031544 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.

15041545

from line 1555

15141555

15151556 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

15161557

1558 format: int32

1559

15171560 - `created_at: string`

15181561

15191562 A timestamp in RFC 3339 format

15201563

1564 format: date-time

1565

15211566 - `memory_store_id: string`

15221567

15231568 ID of the memory store this memory belongs to (a `memstore_...` value).

from line 1577

15321577

15331578 - `type: "memory"`

15341579

1535 - `"memory"`

1536

15371580 - `updated_at: string`

15381581

15391582 A timestamp in RFC 3339 format

15401583

1584 format: date-time

1585

15411586 - `content: optional string or null`

15421587

15431588 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

15441589

1545### Example

1546

1547```http

1590#### Example

1591

1592```bash

15481593curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \

15491594 -H 'anthropic-version: 2023-06-01' \

15501595 -H 'anthropic-beta: agent-memory-2026-07-22' \

15511596 -H "X-Api-Key: $ANTHROPIC_API_KEY"

15521597```

15531598

1554#### Response

1599##### Response (200)

15551600

15561601```json

15571602{

from line 1613

15681613}

15691614```

15701615

1571## Update a memory

1572

1573**post** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

1616### Update a memory

1617

1618**POST** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

15741619

15751620Update a memory

15761621

1577### Path Parameters

1622#### Path parameters

15781623

15791624- `memory_store_id: string`

15801625

15811626- `memory_id: string`

15821627

1583### Query Parameters

1628#### Query parameters

15841629

15851630- `view: optional BetaManagedAgentsMemoryView`

15861631

from line 1635

15901635

15911636 - `"full"`

15921637

1593### Header Parameters

1638#### Headers

15941639

15951640- `"anthropic-beta": optional array of AnthropicBeta`

15961641

from line 1713

16681713

16691714 - `"mid-conversation-tool-changes-2026-07-01"`

16701715

1671### Body Parameters

1716#### Body parameters

16721717

16731718- `content: optional string or null`

16741719

from line 1723

16781723

16791724 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.

16801725

1726 minLength: 2, maxLength: 1024

1727

16811728- `precondition: optional BetaManagedAgentsPrecondition`

16821729

16831730 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.

16841731

16851732 - `type: "content_sha256"`

16861733

1687 - `"content_sha256"`

1688

16891734 - `content_sha256: optional string`

16901735

16911736 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.

16921737

1693### Returns

1694

1695- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

1738#### Returns

1739

1740- `BetaManagedAgentsMemory object`

16961741

16971742 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.

16981743

from line 1753

17081753

17091754 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

17101755

1756 format: int32

1757

17111758 - `created_at: string`

17121759

17131760 A timestamp in RFC 3339 format

17141761

1762 format: date-time

1763

17151764 - `memory_store_id: string`

17161765

17171766 ID of the memory store this memory belongs to (a `memstore_...` value).

from line 1775

17261775

17271776 - `type: "memory"`

17281777

1729 - `"memory"`

1730

17311778 - `updated_at: string`

17321779

17331780 A timestamp in RFC 3339 format

17341781

1782 format: date-time

1783

17351784 - `content: optional string or null`

17361785

17371786 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

17381787

1739### Example

1740

1741```http

1788#### Example

1789

1790```bash

17421791curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \

17431792 -H 'Content-Type: application/json' \

17441793 -H 'anthropic-version: 2023-06-01' \

from line 1796

17471796 -d '{}'

17481797```

17491798

1750#### Response

1799##### Response (200)

17511800

17521801```json

17531802{

from line 1813

17641813}

17651814```

17661815

1767## Delete a memory

1768

1769**delete** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

1816### Delete a memory

1817

1818**DELETE** `/v1/memory_stores/{memory_store_id}/memories/{memory_id}`

17701819

17711820Delete a memory

17721821

1773### Path Parameters

1822#### Path parameters

17741823

17751824- `memory_store_id: string`

17761825

17771826- `memory_id: string`

17781827

1779### Query Parameters

1828#### Query parameters

17801829

17811830- `expected_content_sha256: optional string`

17821831

17831832 Query parameter for expected_content_sha256

17841833

1785### Header Parameters

1834#### Headers

17861835

17871836- `"anthropic-beta": optional array of AnthropicBeta`

17881837

from line 1909

18601909

18611910 - `"mid-conversation-tool-changes-2026-07-01"`

18621911

1863### Returns

1864

1865- `BetaManagedAgentsDeletedMemory object { id, type }`

1912#### Returns

1913

1914- `BetaManagedAgentsDeletedMemory object`

18661915

18671916 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.

18681917

from line 1921

18721921

18731922 - `type: "memory_deleted"`

18741923

1875 - `"memory_deleted"`

1876

1877### Example

1878

1879```http

1924#### Example

1925

1926```bash

18801927curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories/$MEMORY_ID \

18811928 -X DELETE \

18821929 -H 'anthropic-version: 2023-06-01' \

from line 1931

18841931 -H "X-Api-Key: $ANTHROPIC_API_KEY"

18851932```

18861933

1887#### Response

1934##### Response (200)

18881935

18891936```json

18901937{

from line 1940

18931940}

18941941```

18951942

1896## Domain Types

1897

1898### Beta Managed Agents Conflict Error

1899

1900- `BetaManagedAgentsConflictError object { type, message }`

1901

1902 - `type: "conflict_error"`

1903

1904 - `"conflict_error"`

1905

1906 - `message: optional string`

1907

1908### Beta Managed Agents Content Sha256 Precondition

1909

1910- `BetaManagedAgentsContentSha256Precondition object { type, content_sha256 }`

1911

1912 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.

1913

1914 - `type: "content_sha256"`

1915

1916 - `"content_sha256"`

1917

1918 - `content_sha256: optional string`

1919

1920 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.

1921

1922### Beta Managed Agents Deleted Memory

1923

1924- `BetaManagedAgentsDeletedMemory object { id, type }`

1925

1926 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.

1943## Memory Stores › Memory Versions

1944

1945### List memory versions

1946

1947**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`

1948

1949List memory versions

1950

1951#### Path parameters

1952

1953- `memory_store_id: string`

1954

1955#### Query parameters

1956

1957- `api_key_id: optional string`

1958

1959 Query parameter for api_key_id

1960

1961- `"created_at[gte]": optional string`

1962

1963 Return versions created at or after this time (inclusive).

1964

1965 format: date-time

1966

1967- `"created_at[lte]": optional string`

1968

1969 Return versions created at or before this time (inclusive).

1970

1971 format: date-time

1972

1973- `limit: optional number`

1974

1975 Query parameter for limit

1976

1977 format: int32

1978

1979- `memory_id: optional string`

1980

1981 Query parameter for memory_id

1982

1983- `operation: optional BetaManagedAgentsMemoryVersionOperation`

1984

1985 Query parameter for operation

1986

1987 - `"created"`

1988

1989 - `"modified"`

1990

1991 - `"deleted"`

1992

1993- `page: optional string`

1994

1995 Query parameter for page

1996

1997- `service_account_id: optional string`

1998

1999 Query parameter for service_account_id

2000

2001- `session_id: optional string`

2002

2003 Query parameter for session_id

2004

2005- `view: optional BetaManagedAgentsMemoryView`

2006

2007 Query parameter for view

2008

2009 - `"basic"`

2010

2011 - `"full"`

2012

2013#### Headers

2014

2015- `"anthropic-beta": optional array of AnthropicBeta`

2016

2017 Optional header to specify the beta version(s) you want to use.

2018

2019 - `string`

2020

2021 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`

2022

2023 - `"message-batches-2024-09-24"`

2024

2025 - `"prompt-caching-2024-07-31"`

2026

2027 - `"computer-use-2024-10-22"`

2028

2029 - `"computer-use-2025-01-24"`

2030

2031 - `"pdfs-2024-09-25"`

2032

2033 - `"token-counting-2024-11-01"`

2034

2035 - `"token-efficient-tools-2025-02-19"`

2036

2037 - `"output-128k-2025-02-19"`

2038

2039 - `"files-api-2025-04-14"`

2040

2041 - `"mcp-client-2025-04-04"`

2042

2043 - `"mcp-client-2025-11-20"`

2044

2045 - `"dev-full-thinking-2025-05-14"`

2046

2047 - `"interleaved-thinking-2025-05-14"`

2048

2049 - `"code-execution-2025-05-22"`

2050

2051 - `"extended-cache-ttl-2025-04-11"`

2052

2053 - `"context-1m-2025-08-07"`

2054

2055 - `"context-management-2025-06-27"`

2056

2057 - `"model-context-window-exceeded-2025-08-26"`

2058

2059 - `"skills-2025-10-02"`

2060

2061 - `"fast-mode-2026-02-01"`

2062

2063 - `"output-300k-2026-03-24"`

2064

2065 - `"user-profiles-2026-03-24"`

2066

2067 - `"user-profiles-2026-08-18"`

2068

2069 - `"advisor-tool-2026-03-01"`

2070

2071 - `"managed-agents-2026-04-01"`

2072

2073 - `"cache-diagnosis-2026-04-07"`

2074

2075 - `"dreaming-2026-04-21"`

2076

2077 - `"thinking-token-count-2026-05-13"`

2078

2079 - `"server-side-fallback-2026-06-01"`

2080

2081 - `"server-side-fallback-2026-07-01"`

2082

2083 - `"fallback-credit-2026-06-01"`

2084

2085 - `"fallback-credit-2026-07-01"`

2086

2087 - `"agent-memory-2026-07-22"`

2088

2089 - `"mid-conversation-tool-changes-2026-07-01"`

2090

2091#### Returns

2092

2093- `data: optional array of BetaManagedAgentsMemoryVersion`

2094

2095 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.

19272096

19282097 - `id: string`

19292098

1930 ID of the deleted memory (a `mem_...` value).

1931

1932 - `type: "memory_deleted"`

1933

1934 - `"memory_deleted"`

1935

1936### Beta Managed Agents Error

1937

1938- `BetaManagedAgentsError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 9 more`

1939

1940 - `BetaInvalidRequestError object { message, type }`

1941

1942 - `message: string`

1943

1944 - `type: "invalid_request_error"`

1945

1946 - `"invalid_request_error"`

1947

1948 - `BetaAuthenticationError object { message, type }`

1949

1950 - `message: string`

1951

1952 - `type: "authentication_error"`

1953

1954 - `"authentication_error"`

1955

1956 - `BetaBillingError object { message, type }`

1957

1958 - `message: string`

1959

1960 - `type: "billing_error"`

1961

1962 - `"billing_error"`

1963

1964 - `BetaPermissionError object { message, type }`

1965

1966 - `message: string`

1967

1968 - `type: "permission_error"`

1969

1970 - `"permission_error"`

1971

1972 - `BetaNotFoundError object { message, type }`

1973

1974 - `message: string`

1975

1976 - `type: "not_found_error"`

1977

1978 - `"not_found_error"`

1979

1980 - `BetaRateLimitError object { message, type }`

1981

1982 - `message: string`

1983

1984 - `type: "rate_limit_error"`

1985

1986 - `"rate_limit_error"`

1987

1988 - `BetaGatewayTimeoutError object { message, type }`

1989

1990 - `message: string`

1991

1992 - `type: "timeout_error"`

1993

1994 - `"timeout_error"`

1995

1996 - `BetaAPIError object { message, type }`

1997

1998 - `message: string`

1999

2000 - `type: "api_error"`

2001

2002 - `"api_error"`

2003

2004 - `BetaOverloadedError object { message, type }`

2005

2006 - `message: string`

2007

2008 - `type: "overloaded_error"`

2009

2010 - `"overloaded_error"`

2011

2012 - `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`

2013

2014 - `type: "memory_precondition_failed_error"`

2015

2016 - `"memory_precondition_failed_error"`

2017

2018 - `message: optional string`

2019

2020 - `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`

2021

2022 - `type: "memory_path_conflict_error"`

2023

2024 - `"memory_path_conflict_error"`

2025

2026 - `conflicting_memory_id: optional string`

2027

2028 - `conflicting_path: optional string`

2029

2030 - `message: optional string`

2031

2032 - `BetaManagedAgentsConflictError object { type, message }`

2033

2034 - `type: "conflict_error"`

2035

2036 - `"conflict_error"`

2037

2038 - `message: optional string`

2039

2040### Beta Managed Agents Memory

2041

2042- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

2043

2044 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.

2045

2046 - `id: string`

2047

2048 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

2049

2050 - `content_sha256: string`

2051

2052 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`.

2053

2054 - `content_size_bytes: number`

2055

2056 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

2099 Unique identifier for this version (a `memver_...` value).

20572100

20582101 - `created_at: string`

20592102

20602103 A timestamp in RFC 3339 format

20612104

2105 format: date-time

2106

2107 - `memory_id: string`

2108

2109 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.

2110

20622111 - `memory_store_id: string`

20632112

2064 ID of the memory store this memory belongs to (a `memstore_...` value).

2065

2066 - `memory_version_id: string`

2067

2068 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).

2069

2070 - `path: string`

2071

2072 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.

2073

2074 - `type: "memory"`

2075

2076 - `"memory"`

2077

2078 - `updated_at: string`

2079

2080 A timestamp in RFC 3339 format

2113 ID of the memory store this version belongs to (a `memstore_...` value).

2114

2115 - `operation: BetaManagedAgentsMemoryVersionOperation`

2116

2117 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.

2118

2119 - `"created"`

2120

2121 - `"modified"`

2122

2123 - `"deleted"`

2124

2125 - `type: "memory_version"`

20812126

20822127 - `content: optional string or null`

20832128

2084 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

2085

2086### Beta Managed Agents Memory List Item

2087

2088- `BetaManagedAgentsMemoryListItem = BetaManagedAgentsMemory or BetaManagedAgentsMemoryPrefix`

2089

2090 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.

2091

2092 - `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`

2093

2094 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.

2095

2096 - `id: string`

2097

2098 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.

2099

2100 - `content_sha256: string`

2101

2102 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`.

2103

2104 - `content_size_bytes: number`

2105

2106 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.

2107

2108 - `created_at: string`

2109

2110 A timestamp in RFC 3339 format

2111

2112 - `memory_store_id: string`

2113

2114 ID of the memory store this memory belongs to (a `memstore_...` value).

2115

2116 - `memory_version_id: string`

2117

2118 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).

2119

2120 - `path: string`

2121

2122 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.

2123

2124 - `type: "memory"`

2125

2126 - `"memory"`

2127

2128 - `updated_at: string`

2129

2130 A timestamp in RFC 3339 format

2131

2132 - `content: optional string or null`

2133

2134 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).

2135

2136 - `BetaManagedAgentsMemoryPrefix object { path, type }`

2137

2138 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.

2139

2140 - `path: string`

2141

2142 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.

2143

2144 - `type: "memory_prefix"`

2145

2146 - `"memory_prefix"`

2147

2148### Beta Managed Agents Memory Path Conflict Error

2149

2150- `BetaManagedAgentsMemoryPathConflictError object { type, conflicting_memory_id, conflicting_path, message }`

2151

2152 - `type: "memory_path_conflict_error"`

2153

2154 - `"memory_path_conflict_error"`

2155

2156 - `conflicting_memory_id: optional string`

2157

2158 - `conflicting_path: optional string`

2159

2160 - `message: optional string`

2161

2162### Beta Managed Agents Memory Precondition Failed Error

2163

2164- `BetaManagedAgentsMemoryPreconditionFailedError object { type, message }`

2165

2166 - `type: "memory_precondition_failed_error"`

2167

2168 - `"memory_precondition_failed_error"`

2169

2170 - `message: optional string`

2171

2172### Beta Managed Agents Memory Prefix

2173

2174- `BetaManagedAgentsMemoryPrefix object { path, type }`

2175

2176 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.

2177

2178 - `path: string`

2179

2180 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.

2181

2182 - `type: "memory_prefix"`

2183

2184 - `"memory_prefix"`

2185

2186### Beta Managed Agents Memory View

2187

2188- `BetaManagedAgentsMemoryView = "basic" or "full"`

2189

2190 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.

2191

2192 - `"basic"`

2193

2194 - `"full"`

2195

2196### Beta Managed Agents Precondition

2197

2198- `BetaManagedAgentsPrecondition object { type, content_sha256 }`

2199

2200 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.

2201

2202 - `type: "content_sha256"`

2203

2204 - `"content_sha256"`

2205

2206 - `content_sha256: optional string`

2207

2208 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.

2209

2210# Memory Versions

2211

2212## List memory versions

2213

2214**get** `/v1/memory_stores/{memory_store_id}/memory_versions`

2215

2216List memory versions

2217

2218### Path Parameters

2219

2220- `memory_store_id: string`

2221

2222### Query Parameters

2223

2224- `api_key_id: optional string`

2225

2226 Query parameter for api_key_id

2227

2228- `"created_at[gte]": optional string`

2229

2230 Return versions created at or after this time (inclusive).

2231

2232- `"created_at[lte]": optional string`

2233

2234 Return versions created at or before this time (inclusive).

2235

2236- `limit: optional number`

2237

2238 Query parameter for limit

2239

2240- `memory_id: optional string`

2241

2242 Query parameter for memory_id

2243

2244- `operation: optional BetaManagedAgentsMemoryVersionOperation`

2245

2246 Query parameter for operation

2247

2248 - `"created"`

2249

2250 - `"modified"`

2251

2252 - `"deleted"`

2253

2254- `page: optional string`

2255

2256 Query parameter for page

2257

2258- `service_account_id: optional string`

2259

2260 Query parameter for service_account_id

2261

2262- `session_id: optional string`

2263

2264 Query parameter for session_id

2265

2266- `view: optional BetaManagedAgentsMemoryView`

2267

2268 Query parameter for view

2269

2270 - `"basic"`

2271

2272 - `"full"`

2273

2274### Header Parameters

2275

2276- `"anthropic-beta": optional array of AnthropicBeta`

2277

2278 Optional header to specify the beta version(s) you want to use.

2279

2280 - `string`

2281

2282 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`

2283

2284 - `"message-batches-2024-09-24"`

2285

2286 - `"prompt-caching-2024-07-31"`

2287

2288 - `"computer-use-2024-10-22"`

2289

2290 - `"computer-use-2025-01-24"`

2291

2292 - `"pdfs-2024-09-25"`

2293

2294 - `"token-counting-2024-11-01"`

2295

2296 - `"token-efficient-tools-2025-02-19"`

2297

2298 - `"output-128k-2025-02-19"`

2299

2300 - `"files-api-2025-04-14"`

2301

2302 - `"mcp-client-2025-04-04"`

2303

2304 - `"mcp-client-2025-11-20"`

2305

2306 - `"dev-full-thinking-2025-05-14"`

2307

2308 - `"interleaved-thinking-2025-05-14"`

2309

2310 - `"code-execution-2025-05-22"`

2311

2312 - `"extended-cache-ttl-2025-04-11"`

2313

2314 - `"context-1m-2025-08-07"`

2315

2316 - `"context-management-2025-06-27"`

2317

2318 - `"model-context-window-exceeded-2025-08-26"`

2319

2320 - `"skills-2025-10-02"`

2321

2322 - `"fast-mode-2026-02-01"`

2323

2324 - `"output-300k-2026-03-24"`

2325

2326 - `"user-profiles-2026-03-24"`

2327

2328 - `"user-profiles-2026-08-18"`

2329

2330 - `"advisor-tool-2026-03-01"`

2331

2332 - `"managed-agents-2026-04-01"`

2333

2334 - `"cache-diagnosis-2026-04-07"`

2335

2336 - `"dreaming-2026-04-21"`

2337

2338 - `"thinking-token-count-2026-05-13"`

2339

2340 - `"server-side-fallback-2026-06-01"`

2341

2342 - `"server-side-fallback-2026-07-01"`

2343

2344 - `"fallback-credit-2026-06-01"`

2345

2346 - `"fallback-credit-2026-07-01"`

2347

2348 - `"agent-memory-2026-07-22"`

2349

2350 - `"mid-conversation-tool-changes-2026-07-01"`

2351

2352### Returns

2353

2354- `data: optional array of BetaManagedAgentsMemoryVersion`

2355

2356 One page of `memory_version` objects, ordered by `created_at` descending (newest first), with `id` as tiebreak.

2357

2358 - `id: string`

2359

2360 Unique identifier for this version (a `memver_...` value).

2361

2362 - `created_at: string`

2363

2364 A timestamp in RFC 3339 format

2365

2366 - `memory_id: string`

2367

2368 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.

2369

2370 - `memory_store_id: string`

2371

2372 ID of the memory store this version belongs to (a `memstore_...` value).

2373

2374 - `operation: BetaManagedAgentsMemoryVersionOperation`

2375

2376 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.

2377

2378 - `"created"`

2379

2380 - `"modified"`

2381

2382 - `"deleted"`

2383

2384 - `type: "memory_version"`

2385

2386 - `"memory_version"`

2387

2388 - `content: optional string or null`

2389

23902129 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.

23912130

23922131 - `content_sha256: optional string or null`

from line 2136

23972136

23982137 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.

23992138

2139 format: int32

2140

24002141 - `created_by: optional BetaManagedAgentsActor`

24012142

24022143 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).

24032144

2404 - `BetaManagedAgentsSessionActor object { session_id, type }`

2145 - `BetaManagedAgentsSessionActor object`

24052146

24062147 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

24072148

from line 2150

24092150

24102151 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.

24112152

2153 minLength: 1

2154

24122155 - `type: "session_actor"`

24132156

2414 - `"session_actor"`

2415

2416 - `BetaManagedAgentsAPIActor object { api_key_id, type }`

2157 - `BetaManagedAgentsAPIActor object`

24172158

24182159 Attribution for a write made directly via the public API (outside of any session).

24192160

from line 2162

24212162

24222163 ID of the API key that performed the write. This identifies the key, not the secret.

24232164

2165 minLength: 1

2166

24242167 - `type: "api_actor"`

24252168

2426 - `"api_actor"`

2427

2428 - `BetaManagedAgentsUserActor object { type, user_id }`

2169 - `BetaManagedAgentsUserActor object`

24292170

24302171 Attribution for a write made by a human user through the Anthropic Console.

24312172

24322173 - `type: "user_actor"`

24332174

2434 - `"user_actor"`

2435

24362175 - `user_id: string`

24372176

24382177 ID of the user who performed the write (a `user_...` value).

24392178

2440 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

2179 minLength: 1

2180

2181 - `BetaManagedAgentsServiceAccountActor object`

24412182

24422183 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

24432184

from line 2186

24452186

24462187 ID of the service account that performed the write (a `svac_...` value).

24472188

2189 minLength: 1

2190

24482191 - `type: "service_account_actor"`

24492192

2450 - `"service_account_actor"`

2451

24522193 - `path: optional string or null`

24532194

24542195 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.

from line 2198

24572198

24582199 A timestamp in RFC 3339 format

24592200

2201 format: date-time

2202

24602203 - `redacted_by: optional BetaManagedAgentsActor`

24612204

24622205 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).

from line 2208

24652208

24662209 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.

24672210

2468### Example

2469

2470```http

2211#### Example

2212

2213```bash

24712214curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \

24722215 -H 'anthropic-version: 2023-06-01' \

24732216 -H 'anthropic-beta: agent-memory-2026-07-22' \

24742217 -H "X-Api-Key: $ANTHROPIC_API_KEY"

24752218```

24762219

2477#### Response

2220##### Response (200)

24782221

24792222```json

24802223{

from line 2248

25052248}

25062249```

25072250

2508## Retrieve a memory version

2509

2510**get** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`

2251### Retrieve a memory version

2252

2253**GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`

25112254

25122255Retrieve a memory version

25132256

2514### Path Parameters

2257#### Path parameters

25152258

25162259- `memory_store_id: string`

25172260

25182261- `memory_version_id: string`

25192262

2520### Query Parameters

2263#### Query parameters

25212264

25222265- `view: optional BetaManagedAgentsMemoryView`

25232266

from line 2270

25272270

25282271 - `"full"`

25292272

2530### Header Parameters

2273#### Headers

25312274

25322275- `"anthropic-beta": optional array of AnthropicBeta`

25332276

from line 2348

26052348

26062349 - `"mid-conversation-tool-changes-2026-07-01"`

26072350

2608### Returns

2609

2610- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`

2351#### Returns

2352

2353- `BetaManagedAgentsMemoryVersion object`

26112354

26122355 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.

26132356

from line 2362

26192362

26202363 A timestamp in RFC 3339 format

26212364

2365 format: date-time

2366

26222367 - `memory_id: string`

26232368

26242369 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.

from line 2384

26392384

26402385 - `type: "memory_version"`

26412386

2642 - `"memory_version"`

2643

26442387 - `content: optional string or null`

26452388

26462389 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.

from line 2396

26532396

26542397 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.

26552398

2399 format: int32

2400

26562401 - `created_by: optional BetaManagedAgentsActor`

26572402

26582403 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).

26592404

2660 - `BetaManagedAgentsSessionActor object { session_id, type }`

2405 - `BetaManagedAgentsSessionActor object`

26612406

26622407 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

26632408

from line 2410

26652410

26662411 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.

26672412

2413 minLength: 1

2414

26682415 - `type: "session_actor"`

26692416

2670 - `"session_actor"`

2671

2672 - `BetaManagedAgentsAPIActor object { api_key_id, type }`

2417 - `BetaManagedAgentsAPIActor object`

26732418

26742419 Attribution for a write made directly via the public API (outside of any session).

26752420

from line 2422

26772422

26782423 ID of the API key that performed the write. This identifies the key, not the secret.

26792424

2425 minLength: 1

2426

26802427 - `type: "api_actor"`

26812428

2682 - `"api_actor"`

2683

2684 - `BetaManagedAgentsUserActor object { type, user_id }`

2429 - `BetaManagedAgentsUserActor object`

26852430

26862431 Attribution for a write made by a human user through the Anthropic Console.

26872432

26882433 - `type: "user_actor"`

26892434

2690 - `"user_actor"`

2691

26922435 - `user_id: string`

26932436

26942437 ID of the user who performed the write (a `user_...` value).

26952438

2696 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

2439 minLength: 1

2440

2441 - `BetaManagedAgentsServiceAccountActor object`

26972442

26982443 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

26992444

from line 2446

27012446

27022447 ID of the service account that performed the write (a `svac_...` value).

27032448

2449 minLength: 1

2450

27042451 - `type: "service_account_actor"`

27052452

2706 - `"service_account_actor"`

2707

27082453 - `path: optional string or null`

27092454

27102455 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.

from line 2458

27132458

27142459 A timestamp in RFC 3339 format

27152460

2461 format: date-time

2462

27162463 - `redacted_by: optional BetaManagedAgentsActor`

27172464

27182465 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).

27192466

2720### Example

2721

2722```http

2467#### Example

2468

2469```bash

27232470curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID \

27242471 -H 'anthropic-version: 2023-06-01' \

27252472 -H 'anthropic-beta: agent-memory-2026-07-22' \

27262473 -H "X-Api-Key: $ANTHROPIC_API_KEY"

27272474```

27282475

2729#### Response

2476##### Response (200)

27302477

27312478```json

27322479{

from line 2499

27522499}

27532500```

27542501

2755## Redact a memory version

2756

2757**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`

2502### Redact a memory version

2503

2504**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`

27582505

27592506Redact a memory version

27602507

2761### Path Parameters

2508#### Path parameters

27622509

27632510- `memory_store_id: string`

27642511

27652512- `memory_version_id: string`

27662513

2767### Header Parameters

2514#### Headers

27682515

27692516- `"anthropic-beta": optional array of AnthropicBeta`

27702517

from line 2589

28422589

28432590 - `"mid-conversation-tool-changes-2026-07-01"`

28442591

2845### Returns

2846

2847- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`

2592#### Returns

2593

2594- `BetaManagedAgentsMemoryVersion object`

28482595

28492596 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.

28502597

from line 2603

28562603

28572604 A timestamp in RFC 3339 format

28582605

2606 format: date-time

2607

28592608 - `memory_id: string`

28602609

28612610 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.

from line 2625

28762625

28772626 - `type: "memory_version"`

28782627

2879 - `"memory_version"`

2880

28812628 - `content: optional string or null`

28822629

28832630 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.

from line 2637

28902637

28912638 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.

28922639

2640 format: int32

2641

28932642 - `created_by: optional BetaManagedAgentsActor`

28942643

28952644 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).

28962645

2897 - `BetaManagedAgentsSessionActor object { session_id, type }`

2646 - `BetaManagedAgentsSessionActor object`

28982647

28992648 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

29002649

from line 2651

29022651

29032652 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.

29042653

2654 minLength: 1

2655

29052656 - `type: "session_actor"`

29062657

2907 - `"session_actor"`

2908

2909 - `BetaManagedAgentsAPIActor object { api_key_id, type }`

2658 - `BetaManagedAgentsAPIActor object`

29102659

29112660 Attribution for a write made directly via the public API (outside of any session).

29122661

from line 2663

29142663

29152664 ID of the API key that performed the write. This identifies the key, not the secret.

29162665

2666 minLength: 1

2667

29172668 - `type: "api_actor"`

29182669

2919 - `"api_actor"`

2920

2921 - `BetaManagedAgentsUserActor object { type, user_id }`

2670 - `BetaManagedAgentsUserActor object`

29222671

29232672 Attribution for a write made by a human user through the Anthropic Console.

29242673

29252674 - `type: "user_actor"`

29262675

2927 - `"user_actor"`

2928

29292676 - `user_id: string`

29302677

29312678 ID of the user who performed the write (a `user_...` value).

29322679

2933 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

2680 minLength: 1

2681

2682 - `BetaManagedAgentsServiceAccountActor object`

29342683

29352684 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

29362685

from line 2687

29382687

29392688 ID of the service account that performed the write (a `svac_...` value).

29402689

2690 minLength: 1

2691

29412692 - `type: "service_account_actor"`

29422693

2943 - `"service_account_actor"`

2944

29452694 - `path: optional string or null`

29462695

29472696 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.

from line 2699

29502699

29512700 A timestamp in RFC 3339 format

29522701

2702 format: date-time

2703

29532704 - `redacted_by: optional BetaManagedAgentsActor`

29542705

29552706 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).

29562707

2957### Example

2958

2959```http

2708#### Example

2709

2710```bash

29602711curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \

29612712 -X POST \

29622713 -H 'anthropic-version: 2023-06-01' \

from line 2715

29642715 -H "X-Api-Key: $ANTHROPIC_API_KEY"

29652716```

29662717

2967#### Response

2718##### Response (200)

29682719

29692720```json

29702721{

from line 2740

29892740 }

29902741}

29912742```

2992

2993## Domain Types

2994

2995### Beta Managed Agents Actor

2996

2997- `BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor`

2998

2999 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).

3000

3001 - `BetaManagedAgentsSessionActor object { session_id, type }`

3002

3003 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

3004

3005 - `session_id: string`

3006

3007 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.

3008

3009 - `type: "session_actor"`

3010

3011 - `"session_actor"`

3012

3013 - `BetaManagedAgentsAPIActor object { api_key_id, type }`

3014

3015 Attribution for a write made directly via the public API (outside of any session).

3016

3017 - `api_key_id: string`

3018

3019 ID of the API key that performed the write. This identifies the key, not the secret.

3020

3021 - `type: "api_actor"`

3022

3023 - `"api_actor"`

3024

3025 - `BetaManagedAgentsUserActor object { type, user_id }`

3026

3027 Attribution for a write made by a human user through the Anthropic Console.

3028

3029 - `type: "user_actor"`

3030

3031 - `"user_actor"`

3032

3033 - `user_id: string`

3034

3035 ID of the user who performed the write (a `user_...` value).

3036

3037 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

3038

3039 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

3040

3041 - `service_account_id: string`

3042

3043 ID of the service account that performed the write (a `svac_...` value).

3044

3045 - `type: "service_account_actor"`

3046

3047 - `"service_account_actor"`

3048

3049### Beta Managed Agents API Actor

3050

3051- `BetaManagedAgentsAPIActor object { api_key_id, type }`

3052

3053 Attribution for a write made directly via the public API (outside of any session).

3054

3055 - `api_key_id: string`

3056

3057 ID of the API key that performed the write. This identifies the key, not the secret.

3058

3059 - `type: "api_actor"`

3060

3061 - `"api_actor"`

3062

3063### Beta Managed Agents Memory Version

3064

3065- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`

3066

3067 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.

3068

3069 - `id: string`

3070

3071 Unique identifier for this version (a `memver_...` value).

3072

3073 - `created_at: string`

3074

3075 A timestamp in RFC 3339 format

3076

3077 - `memory_id: string`

3078

3079 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.

3080

3081 - `memory_store_id: string`

3082

3083 ID of the memory store this version belongs to (a `memstore_...` value).

3084

3085 - `operation: BetaManagedAgentsMemoryVersionOperation`

3086

3087 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.

3088

3089 - `"created"`

3090

3091 - `"modified"`

3092

3093 - `"deleted"`

3094

3095 - `type: "memory_version"`

3096

3097 - `"memory_version"`

3098

3099 - `content: optional string or null`

3100

3101 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.

3102

3103 - `content_sha256: optional string or null`

3104

3105 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.

3106

3107 - `content_size_bytes: optional number or null`

3108

3109 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.

3110

3111 - `created_by: optional BetaManagedAgentsActor`

3112

3113 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).

3114

3115 - `BetaManagedAgentsSessionActor object { session_id, type }`

3116

3117 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

3118

3119 - `session_id: string`

3120

3121 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.

3122

3123 - `type: "session_actor"`

3124

3125 - `"session_actor"`

3126

3127 - `BetaManagedAgentsAPIActor object { api_key_id, type }`

3128

3129 Attribution for a write made directly via the public API (outside of any session).

3130

3131 - `api_key_id: string`

3132

3133 ID of the API key that performed the write. This identifies the key, not the secret.

3134

3135 - `type: "api_actor"`

3136

3137 - `"api_actor"`

3138

3139 - `BetaManagedAgentsUserActor object { type, user_id }`

3140

3141 Attribution for a write made by a human user through the Anthropic Console.

3142

3143 - `type: "user_actor"`

3144

3145 - `"user_actor"`

3146

3147 - `user_id: string`

3148

3149 ID of the user who performed the write (a `user_...` value).

3150

3151 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

3152

3153 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

3154

3155 - `service_account_id: string`

3156

3157 ID of the service account that performed the write (a `svac_...` value).

3158

3159 - `type: "service_account_actor"`

3160

3161 - `"service_account_actor"`

3162

3163 - `path: optional string or null`

3164

3165 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.

3166

3167 - `redacted_at: optional string or null`

3168

3169 A timestamp in RFC 3339 format

3170

3171 - `redacted_by: optional BetaManagedAgentsActor`

3172

3173 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).

3174

3175### Beta Managed Agents Memory Version Operation

3176

3177- `BetaManagedAgentsMemoryVersionOperation = "created" or "modified" or "deleted"`

3178

3179 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.

3180

3181 - `"created"`

3182

3183 - `"modified"`

3184

3185 - `"deleted"`

3186

3187### Beta Managed Agents Service Account Actor

3188

3189- `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`

3190

3191 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

3192

3193 - `service_account_id: string`

3194

3195 ID of the service account that performed the write (a `svac_...` value).

3196

3197 - `type: "service_account_actor"`

3198

3199 - `"service_account_actor"`

3200

3201### Beta Managed Agents Session Actor

3202

3203- `BetaManagedAgentsSessionActor object { session_id, type }`

3204

3205 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.

3206

3207 - `session_id: string`

3208

3209 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.

3210

3211 - `type: "session_actor"`

3212

3213 - `"session_actor"`

3214

3215### Beta Managed Agents User Actor

3216

3217- `BetaManagedAgentsUserActor object { type, user_id }`

3218

3219 Attribution for a write made by a human user through the Anthropic Console.

3220

3221 - `type: "user_actor"`

3222

3223 - `"user_actor"`

3224

3225 - `user_id: string`

3226

3227 ID of the user who performed the write (a `user_...` value).

32282743

This page’s history 22 edits

22 Oct 2026 +28 −28
21 Oct 2026 +28 −0
21 Oct 2026 +329 −133
16 Oct 2026 +70 −14
14 Oct 2026 +28 −0
12 Oct 2026 +22 −22

The page’s own history →

Where it came from

The captureapi
Upstream pageplatform.claude.com

Around it

Every changethe ledger
That day25 Aug 2026