docs / api
API surfaces
donto exposes one read-only discovery surface that lets you bind a new consumer without ever reading a SQL migration, plus two consumer APIs (memory, genealogy) that double as worked examples of binding.
Substrate API — discovery surface
Read-only introspection of the live substrate. Bind a consumer against these, not against the schema. Full machine-readable spec at /discovery/openapi.
| GET | /discovery/contexts | Every context (graph) in the substrate |
| GET | /discovery/predicate-inventory | Freely-minted predicates ranked by volume |
| GET | /discovery/identity-hypotheses | Active identity (sameAs) hypotheses |
| GET | /discovery/openapi | Full OpenAPI 3 spec for the substrate |
| POST | /search | Full-text search across all 41M+ statements |
| POST | /search/resources | Search source resources → snippet + blob link |
| GET | /statement/:id | A single statement with its evidence |
curl -s https://memories.apexpots.com/discovery/predicate-inventory | jq '.predicates[:5]'
curl -s -XPOST https://memories.apexpots.com/search \
-H 'Content-Type: application/json' \
-d '{"query":"Caroline Rose Davis","limit":8}'Memory API
Persistent, recallable memory for agents — text in, anchored claims out. Live at memory.donto.org; the recall pipeline is documented in How it solves things.
| POST | /memorize | Extract claims from text and ingest them |
| POST | /recall | Holder-scoped recall bundle (FTS + vector + RRF) |
| POST | /search | Rank across the whole substrate |
| GET | /jobs/:id | Status of a deferred extraction job |
Genealogy API
Evidence-first family research — the hardest test of the claim lifecycle. Live at genealogy.donto.org.
| POST | /jobs/extract | Extract + ingest facts from a source |
| POST | /search/resources | Search stored source resources |
| GET | /claim/:id | A claim with its evidence snippet + full-resource link |
Bind a consumer
- 1Read
/discovery/contract-versionand/discovery/openapi— that is the entire contract. - 2Pick or create a context (graph):
POST /contexts/ensure. - 3Emit claims with
donto-extract(free predicates, anchored to evidence) and ingest them. - 4Query: align predicates at query time, search across the substrate, resolve identity hypotheses on demand.