Skip to main content

Atoms API

Endpoints over the substrate-v2 graph.

List atoms in a project

GET /api/projects/[projectId]/atoms?kind=fact&limit=50

Returns up to 50 atoms filtered by kind.

Search atoms

GET /api/projects/[projectId]/search?q=milestone&kinds=fact,obligation

Full-text search using the tsvector column from P20.1. See

/docs/api/search for the response shape.

Atom detail

GET /api/atoms/[atomId]

Returns the atom, its source quote and document, and outgoing /

incoming edges.

Edges

Edges are read-only over the API. Writes happen via the engines

(e.g. baseline lock writes the supersedes edges).

Cross links

  • /docs/concepts/atoms: what an atom is
  • /docs/engines/extract: how atoms are created