Memory - Herm

Observational memory is what the agent learns about a customer across sessions. The agent writes it autonomously; these endpoints let your product read it, seed it at onboarding, correct it, or honor a deletion request.

List memories

GET /v1/deployments/:deployment_id/memories

const { data } = await herm.memories.list("dep_7xK9s2", { q: "brand" });

Parameter	Type	Required	Description
`q`	string	No	Filter memories by keyword
`limit`	integer	No	Page size, 1–100. Defaults to 20
`cursor`	string	No	Pagination cursor from a previous response

{
  "data": [
    {
      "memory_id": "mem_2dF8h1",
      "content": "Always end videos with the Acme logo sting.",
      "source": "agent",
      "created_at": "2026-06-09T17:30:12Z"
    }
  ],
  "next_cursor": null
}

source is agent for observations the agent recorded itself and api for memories you created.

Get a memory

GET /v1/deployments/:deployment_id/memories/:memory_id

const memory = await herm.memories.get("dep_7xK9s2", "mem_2dF8h1");

Create a memory

POST /v1/deployments/:deployment_id/memories

Seed durable context at onboarding so the agent starts informed instead of learning everything from scratch.

const memory = await herm.memories.create("dep_7xK9s2", {
  content:
    "Acme's brand voice is playful but never sarcastic. Primary color #7C3AED.",
});

{
  "memory_id": "mem_8nW3p4",
  "content": "Acme's brand voice is playful but never sarcastic. Primary color #7C3AED.",
  "source": "api",
  "created_at": "2026-06-11T21:18:44Z"
}

Update a memory

PATCH /v1/deployments/:deployment_id/memories/:memory_id

await herm.memories.update("dep_7xK9s2", "mem_2dF8h1", {
  content: "End videos with the new Acme logo sting (v2, March 2026).",
});

Delete a memory

DELETE /v1/deployments/:deployment_id/memories/:memory_id

await herm.memories.delete("dep_7xK9s2", "mem_2dF8h1");

Use this for customer data-deletion requests; the agent won’t re-learn a deleted memory unless the customer repeats it.

Errors

Status	Error	When
400	`validation_error`	Invalid request body
404	`not_found`	Deployment or memory does not exist

See Errors for the full error reference.

​List memories

​Get a memory

​Create a memory

​Update a memory

​Delete a memory

​Errors