from line 1
1---
2title: Create a memory
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create
4---
1# Create a memory
52
6## Create a memory
3**POST** `/v1/memory_stores/{memory_store_id}/memories`
74
8**post** `/v1/memory_stores/{memory_store_id}/memories`
9
105Create a memory
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `view: optional BetaManagedAgentsMemoryView`
1914
from line 18
2318
2419 - `"full"`
2520
26### Header Parameters
21## Headers
2722
2823- `"anthropic-beta": optional array of AnthropicBeta`
2924
from line 96
10196
10297 - `"mid-conversation-tool-changes-2026-07-01"`
10398
104### Body Parameters
99## Body parameters
105100
106101- `content: string or null`
107102
from line 106
111106
112107 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.
113108
114### Returns
109 minLength: 2, maxLength: 1024
115110
116- `BetaManagedAgentsMemory object { id, content_sha256, content_size_bytes, 7 more }`
111## Returns
117112
113- `BetaManagedAgentsMemory object`
114
118115 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.
119116
120117 - `id: string`
from line 126
129126
130127 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
131128
129 format: int32
130
132131 - `created_at: string`
133132
134133 A timestamp in RFC 3339 format
135134
135 format: date-time
136
136137 - `memory_store_id: string`
137138
138139 ID of the memory store this memory belongs to (a `memstore_...` value).
from line 148
147148
148149 - `type: "memory"`
149150
150 - `"memory"`
151
152151 - `updated_at: string`
153152
154153 A timestamp in RFC 3339 format
155154
155 format: date-time
156
156157 - `content: optional string or null`
157158
158159 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
159160
160### Example
161## Example
161162
162```http
163```bash
163164curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memories \
164165 -H 'Content-Type: application/json' \
165166 -H 'anthropic-version: 2023-06-01' \
from line 172
171172 }'
172173```
173174
174#### Response
175### Response (200)
175176
176177```json
177178{
No line in this hunk matches that.