Managing Your Graph

A knowledge graph requires periodic maintenance to stay useful. Here’s how to keep yours healthy.

Weekly: Analyze

The analyze operation reviews your graph and returns actionable insights:

curl -X POST https://api.cortex-app.dev/api/graph/analyze \
  -H "Authorization: Bearer YOUR_TOKEN"

It returns:

• Clusters: Groups of 3+ densely connected notes → Write synthesis notes
• Bridge notes: Notes connecting separate clusters → These are high-value
• Orphans: Unlinked notes → Connect them or consider deleting
• Stale notes: Notes not accessed in 30+ days → Review or archive

Monthly: Cleanup

Notes naturally lose relevance over time. The cleanup system helps:

Preview First (Dry Run)

curl -X POST https://api.cortex-app.dev/api/graph/cleanup \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"dry_run": true}'

Then Execute

curl -X POST https://api.cortex-app.dev/api/graph/cleanup \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"dry_run": false}'

Cleanup Resistance

Some notes resist decay:

• Pinned notes: Never decay
• Importance ≥ 0.7: Strong resistance
• Recently accessed: Resets decay timer
• Many links: Well-connected notes decay slower

Quarterly: Summary Regeneration

The summary is an auto-loaded overview of your most important knowledge:

curl -X POST https://api.cortex-app.dev/api/graph/summary \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"regenerate": true}'

This creates a fresh overview of your highest-importance, most-accessed notes.

Graph Health Indicators