MemoryKit

Create Memory

Store a new memory. Content is processed asynchronously.

POST/v1/memories

Request body

contentstringrequired

The text content to store.

titlestring

Title for the memory. Auto-extracted from content if omitted.

typestring

Content type. Auto-detected if omitted.

tagsstring[]

Tags for filtering and organization.

formatstring

Content format hint (e.g., markdown, html). Helps the chunking engine.

languagestring

ISO 639-1 language code (e.g., en, ru). Auto-detected if omitted.

metadataobject

Arbitrary key-value pairs attached to the memory.

userIdstring

Associate this memory with a specific user.

Response

Returns 202 Accepted with the memory object.

idstring

Unique memory identifier (e.g., mem_abc123).

statusstring

Processing status: processing, completed, or failed.

contentstring

The stored content.

titlestring

Memory title.

tagsstring[]

Tags associated with the memory.

created_atstring

ISO 8601 timestamp.

Example response
{
  "id": "mem_abc123",
  "status": "processing",
  "content": "Meeting notes from Q4 planning...",
  "title": "Q4 Planning Notes",
  "tags": ["planning", "q4"],
  "created_at": "2025-01-15T10:30:00Z"
}
const memory = await mk.memories.create({
  content: "Meeting notes from Q4 planning...",
  title: "Q4 Planning Notes",
  tags: ["planning", "q4"],
});
Edit on GitHub

On this page