Skip to main content
Price: $0.001 USDC

Request Body

content
string
required
The memory text. Max 8,192 characters.
metadata
object
Arbitrary key-value metadata. Max 4 KB, 20 keys, 3 levels deep.
importance
number
Float between 0 and 1. Affects ranking in recall. Default: 0.5.
namespace
string
Isolate memories per project or context. Default: "default". Max 255 characters.

Response (201 Created)

id
string
UUID of the stored memory.
stored
boolean
Always true.
tokens_used
number
Embedding tokens consumed.

Example

curl -X POST https://api.memoclaw.dev/v1/store \
  -H "Content-Type: application/json" \
  -d '{
    "content": "User prefers dark mode and vim keybindings",
    "metadata": {
      "tags": ["preferences", "ui"]
    },
    "importance": 0.8
  }'
Response
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "stored": true,
  "tokens_used": 15
}