Experimental, early beta. Data model and interfaces are unstable; expect breaking changes between releases.

HTTP API

Noumenon's daemon speaks plain JSON over HTTP. The CLI launcher and the desktop UI both go through this surface; you can too.

Response Shape

Every endpoint returns a JSON envelope: {ok: true, data: ...} on success, {ok: false, error: "..."} on failure. Long-running POSTs stream progress as Server-Sent Events when called with Accept: text/event-stream.

Health · 1

MethodPathSummary
GET/healthDaemon health check

Pipeline · 6

MethodPathSummary
POST/api/analyzeRun LLM semantic analysis
POST/api/digestRun full pipeline (import, enrich, analyze, benchmark)
POST/api/enrichExtract cross-file import graph (no LLM)
POST/api/importImport git history and file structure
POST/api/reseedReload prompts, queries, and rules
POST/api/updateSync knowledge graph with latest git state

Branches · 1

MethodPathSummary
POST/api/delta/ensureMaterialize or refresh the local delta DB for a feature branch

Querying · 8

MethodPathSummary
POST/api/askAsk a question using AI-powered iterative querying
GET/api/queriesList available named queries
POST/api/queryRun a named Datalog query
POST/api/query-as-ofRun a named query against a historical database value
POST/api/query-federatedRun a named query merged across trunk and a local delta DB
POST/api/query-rawRun an ad-hoc Datalog query (EDN string)
GET/api/schema/{repo}Get database schema
GET/api/status/{repo}Get entity counts

Databases · 2

MethodPathSummary
GET/api/databasesList all databases
DELETE/api/databases/{name}Delete a database

Benchmarks · 3

MethodPathSummary
POST/api/benchmarkRun benchmark evaluation
GET/api/benchmark/compareCompare two benchmark runs
GET/api/benchmark/resultsGet benchmark results

Introspection · 4

MethodPathSummary
POST/api/introspectRun autonomous self-improvement loop
GET/api/introspect/historyQuery introspect history
GET/api/introspect/statusCheck introspect session status
POST/api/introspect/stopStop a running introspect session

Admin · 1

MethodPathSummary
GET/api/artifacts/historyShow artifact change history

Full request/response shapes live in the OpenAPI spec: /openapi.yaml. Source-of-truth in the noumenon repo: resources/openapi.yaml.