Memories

Memories are the core storage unit. Each memory holds content that gets chunked, embedded, and indexed for retrieval. Smart Ingestion automatically extracts title, tags, language, and content type.

Create a memory

POST /v1/memories — Returns 202 Accepted. Content is processed asynchronously.

const memory = await mk.memories.create({
  content: "Meeting notes from Q4 planning...",
  title: "Q4 Planning Notes",
  type: "meeting",
  tags: ["planning", "q4"],
  metadata: { department: "engineering" },
  userId: "user_123",
});

Parameters

Parameter	Type	Required	Description
`content`	string	Yes	The text content to store
`title`	string	No	Title for the memory (auto-extracted if omitted)
`type`	string	No	Content type (auto-detected if omitted)
`tags`	string[]	No	Tags for filtering (auto-extracted if omitted)
`metadata`	object	No	Arbitrary key-value metadata
`userId`	string	No	Associate with a specific user

List memories

GET /v1/memories — Cursor-based pagination. Filter by status, type, or user.

const list = await mk.memories.list({
  limit: 20,
  status: "completed",
  userId: "user_123",
});
 
// list.data — Memory[]
// list.has_more — boolean

Delete a memory

DELETE /v1/memories/:id — Soft delete. Returns 204.

await mk.memories.delete("memory_uuid");

Create a memory

Parameters

List memories

Delete a memory

On this page