Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ntrp.io/llms.txt

Use this file to discover all available pages before exploring further.

Facts

List facts

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

Get fact

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

Update fact

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

Delete fact

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

Observations

List observations

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

Get observation

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

Update observation

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

Delete observation

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

Dreams

List dreams

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

Get dream

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

Delete dream

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

Stats

curl http://localhost:6877/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:6877/memory/clear \
  -H "Authorization: Bearer $API_KEY"
Clear only observations (keep facts):
curl -X POST http://localhost:6877/memory/observations/clear \
  -H "Authorization: Bearer $API_KEY"