API Reference
Memory API
API reference for the 5-layer agent memory stack — working, episodic, semantic, procedural, and meta-memory — via the /memory-stores resource.
Memory Stores
A memory store belongs to an agent and holds entries of a given type (semantic, episodic, procedural, context, or artifact).
Create a Memory Store for an Agent
POST /api/v1/memory-stores/agents/{agent_id}/memory-stores
# Request
curl -X POST "https://www.vouchstone.ai/api/v1/memory-stores/agents/agent_abc123/memory-stores?tenant_id=tenant_xyz" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Support KB",
"memory_type": "semantic"
}'Run Consolidation on a Store
POST /api/v1/memory-stores/{store_id}/consolidate
curl -X POST https://www.vouchstone.ai/api/v1/memory-stores/store_abc123/consolidate \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
# Response
{
"store_id": "store_abc123",
"status": "started",
"strategies": ["summarize"],
"message": "Consolidation job started"
}Memory Entries
Entries are the individual memories inside a tenant's stores. memory_type is one of semantic, episodic, procedural, context, or artifact.
Create an Entry
POST /api/v1/memory-stores/entries
# Request
curl -X POST "https://www.vouchstone.ai/api/v1/memory-stores/entries?tenant_id=tenant_xyz" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"memory_type": "semantic",
"key": "refund_policy",
"content": "Company refund policy: 30 days, unopened items only.",
"tags": ["policy", "billing"],
"importance_score": 0.8
}'List / Filter Entries
GET /api/v1/memory-stores/entries
curl "https://www.vouchstone.ai/api/v1/memory-stores/entries?tenant_id=tenant_xyz&memory_type=episodic&search=password" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
# Response
{
"entries": [ { "id": "...", "key": "...", "content": "...", "memory_type": "episodic", "importance_score": 0.6 } ],
"total": 156,
"skip": 0,
"limit": 20
}Search Entries
POST /api/v1/memory-stores/entries/search
curl -X POST "https://www.vouchstone.ai/api/v1/memory-stores/entries/search?tenant_id=tenant_xyz" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "refund",
"memory_type": "semantic",
"min_importance": 0.5,
"limit": 10
}'Update / Delete an Entry
PUT /api/v1/memory-stores/entries/{entry_id}
DELETE /api/v1/memory-stores/entries/{entry_id}
Decision Graphs
Decision graphs are their own top-level resource, not nested under memory — see GET /api/v1/decision-graphs, POST /api/v1/decision-graphs, and POST /api/v1/decision-graphs/{graph_id}/execute. They back the routing/hierarchical Collective strategies.