Store Batch

POST /v1/store/batch — Store up to 100 memories in a single request.

POST /v1/store/batch

Store Batch

cURL

curl --request POST \
  --url https://api.memoclaw.com/v1/store/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "memories": [
    {
      "memories[].content": "<string>",
      "memories[].metadata": {},
      "memories[].importance": 123,
      "memories[].namespace": "<string>",
      "memories[].memory_type": "<string>",
      "memories[].session_id": "<string>",
      "memories[].agent_id": "<string>",
      "memories[].expires_at": "<string>",
      "memories[].pinned": true,
      "memories[].immutable": true
    }
  ]
}
'

200

{
  "ids": [
    "<string>"
  ],
  "stored": true,
  "count": 123,
  "deduplicated_count": 123,
  "tokens_used": 123
}

Price: $0.04 USDC

Request Body

memories · array · required

Array of memory objects. Min 1, max 100. Each object accepts the same fields as Store Memory.

Show Memory object fields

memories[].content · string · required

The memory text. Max 8,192 characters.

memories[].metadata · object

Arbitrary key-value metadata. Max 4 KB, 20 keys, 3 levels deep.

memories[].importance · number

Float between 0 and 1. Default: 0.5.

memories[].namespace · string

Namespace to isolate memories. Default: "default". Max 255 characters.

memories[].memory_type · string

One of: correction, preference, decision, project, observation, general. Default: "general".

memories[].session_id · string

Session identifier. Max 255 characters.

memories[].agent_id · string

Agent identifier. Max 255 characters.

memories[].expires_at · string

ISO 8601 date string. Must be in the future.

memories[].pinned · boolean

Pin this memory to exempt it from decay. Default: false.

memories[].immutable · boolean

Lock the memory from future updates and deletes. Default: false.

Response (201 Created)

ids · string[]

Array of UUIDs for the stored memories.

stored · boolean

Always true.

count · number

Number of memories stored.

deduplicated_count · number

Number of memories that were deduplicated (merged with existing similar memories).

tokens_used · number

Total embedding tokens consumed.

Example

curl

curl -X POST https://api.memoclaw.com/v1/store/batch \
  -H "Content-Type: application/json" \
  -d '{
    "memories": [
      {
        "content": "User prefers dark mode and vim keybindings",
        "metadata": { "tags": ["preferences"] },
        "importance": 0.8
      },
      {
        "content": "Project uses PostgreSQL with pgvector extension",
        "metadata": { "tags": ["stack", "database"] },
        "importance": 0.6
      }
    ]
  }'

Response

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "stored": true,
  "count": 2,
  "deduplicated_count": 0,
  "tokens_used": 28
}