Batch Update

PATCH /v1/memories/batch — Update multiple memories in a single request.

PATCH /v1/memories/batch

Batch Update

cURL

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

200

{
  "updated": 123,
  "errors": [
    {
      "errors[].id": "<string>",
      "errors[].status": 123,
      "errors[].message": "<string>"
    }
  ]
}

This endpoint requires an x402 payment header.

Price: $0.005 USDC

Update multiple memories at once. Each update object must include the memory id and at least one field to change. If content is changed on any memory, its embedding is regenerated.

Request Body

updates · array · required

Array of update objects. Min 1, max 100. Each must include id plus at least one field to change.

Show Update object fields

updates[].id · string · required

UUID of the memory to update.

updates[].content · string

New memory text. Max 8,192 characters. Triggers re-embedding.

updates[].metadata · object

Replace metadata entirely. Max 4 KB, 20 keys, 3 levels deep.

updates[].importance · number

Float between 0 and 1.

updates[].memory_type · string

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

updates[].namespace · string

Move memory to a different namespace. Max 255 characters.

updates[].pinned · boolean

Pin or unpin the memory.

updates[].expires_at · string | null

ISO 8601 date string or null to clear expiration.

updates[].immutable · boolean

Lock the memory permanently. One-way operation.

Immutable memories in the batch are skipped and returned in the errors array with a 409 status. The rest of the batch still processes.

Response (200)

updated · number

Number of memories successfully updated.

errors · array

Array of error objects for memories that failed to update.

Show Error object fields

errors[].id · string

UUID of the memory that failed.

errors[].status · number

HTTP status code (404, 409, 422).

errors[].message · string

Error description.

Example

curl

curl -X PATCH https://api.memoclaw.com/v1/memories/batch \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "importance": 0.95,
        "pinned": true
      },
      {
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "content": "Updated: team now uses pnpm instead of npm",
        "metadata": { "tags": ["stack", "tooling"] }
      }
    ]
  }'

Response

{
  "updated": 2,
  "errors": []
}

Errors

Status	Description
404	Memory not found (skipped, reported in errors).
409	Memory is immutable (skipped, reported in errors).
422	Invalid request body or field validation failed.