Skip to main content

​
Facts

​
List facts

curl "http://localhost:8000/facts?limit=20&offset=0" \
  -H "Authorization: Bearer $API_KEY"

​
Get fact

curl http://localhost:8000/facts/42 \
  -H "Authorization: Bearer $API_KEY"
Returns the fact with its entities and linked facts.

​
Update fact

curl -X PATCH http://localhost:8000/facts/42 \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Updated fact text"}'

​
Delete fact

curl -X DELETE http://localhost:8000/facts/42 \
  -H "Authorization: Bearer $API_KEY"

​
Observations

​
List observations

curl http://localhost:8000/observations \
  -H "Authorization: Bearer $API_KEY"

​
Get observation

curl http://localhost:8000/observations/7 \
  -H "Authorization: Bearer $API_KEY"
Returns the observation with its supporting facts.

​
Update observation

curl -X PATCH http://localhost:8000/observations/7 \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"summary": "Updated observation"}'

​
Delete observation

curl -X DELETE http://localhost:8000/observations/7 \
  -H "Authorization: Bearer $API_KEY"

​
Dreams

​
List dreams

curl http://localhost:8000/dreams \
  -H "Authorization: Bearer $API_KEY"

​
Get dream

curl http://localhost:8000/dreams/3 \
  -H "Authorization: Bearer $API_KEY"

​
Delete dream

curl -X DELETE http://localhost:8000/dreams/3 \
  -H "Authorization: Bearer $API_KEY"

​
Stats

curl http://localhost:8000/stats \
  -H "Authorization: Bearer $API_KEY"

{
  "fact_count": 245,
  "observation_count": 38,
  "dream_count": 5
}

​
Purge

Delete all memory data: 
curl -X POST http://localhost:8000/memory/clear \
  -H "Authorization: Bearer $API_KEY"
Clear only observations (keep facts): 
curl -X POST http://localhost:8000/memory/observations/clear \
  -H "Authorization: Bearer $API_KEY"