Skip to main content
PUT
/
api
/
v1
/
memory
/
blocks
/
{block_type}
Update Memory Block
curl --request PUT \
  --url https://api.example.com/api/v1/memory/blocks/{block_type}

​
Path Parameters

ParameterTypeDescription
block_typecore, archivalMemory block to update

​
Query Parameters

ParameterTypeDescription
scopeuser, agentDefaults to user
agent_idstringRequired when scope=agent

​
Request Body

{
  "content": "- Prefers concise summaries",
  "expected_updated_at": "2026-04-30T16:30:00"
}
expected_updated_at is required. Send the last-read updated_at value when replacing an existing block. Send null only when creating a block that should not already exist. Concurrent edits return 409 Conflict.

​
Response

{
  "id": "mem_123",
  "block_type": "core",
  "content": "- Prefers concise summaries",
  "scope": "user",
  "agent_id": null,
  "created_at": "2026-04-30T16:00:00",
  "updated_at": "2026-04-30T16:35:00"
}