Developer API / Overview
The engine, as a procedure.
A small HTTP surface over a deterministic relational substrate. Observe text, ask a question, emit a traversal, derive an edge. No sampling. No model call. No external knowledge.
The public host is a temporary address: https://api.gnomon.one. Access is provisioned; there is no self-serve key issuance. See Access.
The surface
| Method | Route | Credential | Returns |
|---|---|---|---|
| GET | /health | None | {"status":"ok"} |
| GET | /status | Developer | Substrate and capacity counters |
| GET | /instance | Developer | Version, origin, clock, node count |
| GET | /account | Developer | The caller's account record |
| POST | /observe | Developer | {"node":"<hash>"} |
| POST | /observe-seq | Developer | {"nodes":["<hash>", "..."]} |
| POST | /query | Developer | {"emitted_text":"..."} |
| POST | /emit | Developer | {"verdict":"...","emitted_text":"..."} |
| POST | /derive | Developer | {"promoted":false} |
The HTTP surface is deliberately smaller than the Python engine. Operator routes for account and security administration are not part of the developer contract.
What a session looks like
- 01
Observe
Admit text as a node. The response is its 16-character invariant hash.
- 02
Relate
Use
/observe-seqto admit an ordered sequence. The sequence writes directed transitions; a single node has nowhere to traverse. - 03
Query or emit
/queryanchors on a hash or admits unknown text first./emitonly reads an existing anchor. An absent anchor is a seam, not a new node. - 04
Derive
Reconstruct a justification between two nodes. Promotion is earned through the gate; the HTTP route reports whether it happened.
What it is not
This is not a chat-completion endpoint, a vector store, or an embedding database. It does not consult external knowledge. It derives from relations that have been admitted into the instance.
Instance model
Each instance is single-tenant. Accounts and tokens are access control, not memory partitioning. Do not treat two accounts on one instance as isolated tenants.
The server is intentionally single-threaded: calls are serialized so ordering is deterministic. There is no HTTP route to clear nodes or reset the substrate. Treat every observation as durable.
Start here
Procedure 01
Quickstart
From a token to a first observation, query, emit, and derivation.
Run itProcedure 02
Authentication
Bearer tokens, tiers, expiry, and the difference between 401 and 403.
Read the modelReference 01
HTTP API
Every developer route, payload, response, and failure mode.
Open the referenceAccess
Request an instance
Hosted evaluation and private deployment are provisioned, not self-serve.
Request access