Add a memory item with optional full ingestion pipeline.
Requires authentication and operates on user-scoped data.
Args:
content: The memory content
memory_type: Type of memory (semantic, episodic, procedural)
metadata: Additional metadata
use_pipeline: If True, uses full ingestion pipeline with entity extraction (default: True)
conversation_context: Optional conversation context for conversation-aware entity extraction
embed: SVC-EMBED-CONTROL-1 tri-state embedding override. True forces an
embedding, False suppresses one, None (default) leaves existing
behaviour untouched. Only honoured when use_pipeline is False —
see the 400 below.
Note:
Provenance like retrieved_context_ids travels in metadata — the storage
layer flattens metadata onto the node and lifts known fields back onto the
MemoryItem on read, so no dedicated body field is needed (GRAPH-API-1i,
wire field added then removed 2026-08-02; metadata takes precedence at
storage regardless, node_types.py).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/memory/add" \ -H "Content-Type: application/json" \ -d '{ "content": "string" }'null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Add Edge
Add a direct edge between two nodes in the graph. This is a lower-level operation than link() - it creates a raw edge with custom properties. Use link() for standard memory linking. Requires authentication and validates memory ownership with tenant isolation.
Add Team Member
Add a user to a team. Requires team admin or tenant admin.