remember

Store one fact.

POST/v1/remember

Also an MCP tool named remember.

FieldTypeRequiredDescription
subjectstringyes

Entity the fact is about. Prefer type:id (user:123). Max 512 characters.

predicatestringyes

Relationship. Use stable snake_case (works_at, has_skill). Max 512.

objectstringyes

Related entity (type:id) or a literal value. Max 512.

contextstringno

Optional note. Max 4000 characters. Not part of the triple.

collectionstringno

Collection code. Omit for the connection default. "" forces the default bucket.

normalizebooleanno

MCP only. When true, rewrite the triple before storing. REST ignores this field.

Request

{
  "subject": "user:maya",
  "predicate": "works_at",
  "object": "company:acme",
  "context": "Mentioned in onboarding"
}

Response

result is the stored fact:

{
  "subject": "user:maya",
  "predicate": "works_at",
  "object": "company:acme",
  "context": "Mentioned in onboarding"
}

Literals return value instead of object.