API / Memory
Store a durable fact for a namespace you control. Preferences, constraints, past purchases, rejected options — anything the next session should not have to ask about again.
POST /v1/memory
| Name | Type | Notes |
|---|---|---|
| namespace | string | Your scope for one end user or agent. |
| kind | string | preference | constraint | purchase | rejection | intent. |
| body | string | The fact, in plain language. |
| subject | object | Optional product_id, brand or category it attaches to. |
| ttl_days | int | Optional expiry. Constraints usually outlive intents. |
POST /v1/memory
{ "namespace": "user_9f21",
"kind": "constraint",
"body": "never recommend anything with a subscription attached",
"ttl_days": 365 }
→ 201
{ "memory_id": "mem_0c81a", "namespace": "user_9f21" }