Client

Get user profile

POST/v4/profile

Add document

POST/v3/documents

ModelsExpand Collapse

ProfileResponse object { profile, searchResults }

profile: object { buckets, dynamic, static }

buckets: optional map[array of string]

Per-bucket memory lists, keyed by bucket key

dynamic: optional array of string

Dynamic profile information (recent memories)

static: optional array of string

Static profile information that remains relevant long-term

searchResults: optional object { results, timing, total }

Search results if a search query was provided

results: array of object { id, metadata, similarity, 10 more }

Search results for the provided query

id: string

Memory entry ID or chunk ID

metadata: map[unknown]

Memory metadata

similarity: number

Similarity score between the query and memory entry

maximum1

minimum0

updatedAt: string

Memory last update date

formatdatetime

chunk: optional string

The chunk content (only present for chunk results from hybrid search)

chunks: optional array of object { content, documentId, position }

Relevant chunks from associated documents (only included when chunks=true)

content: string

Content of the chunk

documentId: string

ID of the document this chunk belongs to

position: number

Position of chunk in the document (0-indexed)

context: optional object { children, parents, related }

Object containing version history (parents/children via updates) and related memories (extends/derives)

children: optional array of object { memory, relation, updatedAt, 2 more }

memory: string

The contextual memory content

relation: "updates" or "extends" or "derives"

Relation type between this memory and its parent/child

One of the following:

"updates"

"extends"

"derives"

updatedAt: string

Contextual memory last update date

formatdatetime

metadata: optional map[unknown]

Contextual memory metadata

version: optional number

Relative version distance from the primary memory (+1 for direct child, +2 for grand-child, etc.)

parents: optional array of object { memory, relation, updatedAt, 2 more }

memory: string

The contextual memory content

relation: "updates" or "extends" or "derives"

Relation type between this memory and its parent/child

One of the following:

"updates"

"extends"

"derives"

updatedAt: string

Contextual memory last update date

formatdatetime

metadata: optional map[unknown]

Contextual memory metadata

version: optional number

Relative version distance from the primary memory (-1 for direct parent, -2 for grand-parent, etc.)

One of the following:

documents: optional array of object { id, createdAt, updatedAt, 4 more }

Associated documents for this memory entry

id: string

Document ID

createdAt: string

Document creation date

formatdatetime

updatedAt: string

Document last update date

formatdatetime

metadata: optional map[unknown]

Document metadata (only included when documents=true)

summary: optional string

Document summary (only included when summaries=true)

title: optional string

Document title (only included when documents=true)

type: optional string

Document type (only included when documents=true)

filepath: optional string

Filepath of the source document this memory or chunk came from

isAggregated: optional boolean

Indicates if this memory was created by aggregating multiple source memories

memory: optional string

The memory content (only present for memory results)

rootMemoryId: optional string

ID of the root (first version) memory entry this one descends from. Null for memories that have never been superseded. Only present on memory results, not on standalone chunk results.

version: optional number

Version number of this memory entry

timing: number

Search timing in milliseconds

total: number

Total number of search results

AddResponse object { id, status }

id: string

Unique identifier of the document

status: string

Status of the document