HTTP reference.

Liveness only. It does not prove a snapshot loaded or that the substrate is empty.

curl -sS "$GNOMON_API_URL/v1/health"

{"status":"ok"}

Developer status plus capacity. The values are a copy, not a live subscription.

curl -sS "$GNOMON_API_URL/v1/status" -H "Authorization: Bearer $GNOMON_TOKEN"

{
  "working_memory": 0,
  "cognitive_load": "STABLE",
  "staging_memory": 0,
  "strict_mode": true,
  "grounding_guard": true,
  "total_production_nodes": 0,
  "total_production_transitions": 0,
  "total_songs": 0,
  "capacity": {
    "max_nodes": null,
    "total_nodes": 0,
    "remaining_nodes": null,
    "at_capacity": false
  }
}

capacity.remaining_nodes is null when the instance is unbounded. Check at_capacity before admitting a batch.

Instance identity and counters. The origin id binds tokens to this deployment.

curl -sS "$GNOMON_API_URL/v1/instance" -H "Authorization: Bearer $GNOMON_TOKEN"

{
  "version": "0.11.0",
  "node_count": 0,
  "tick": 0,
  "heartbeat": 0,
  "accounts_enabled": true,
  "origin_id": "<origin-id>",
  "clock": 0,
  "account_count": 1
}

The authenticated caller's record. It contains no token material.

curl -sS "$GNOMON_API_URL/v1/account" -H "Authorization: Bearer $GNOMON_TOKEN"

{
  "account": {
    "account_id": "<16-hex>",
    "name": "...",
    "tier": "DEVELOPER",
    "status": "ACTIVE",
    "epoch": 1,
    "min_epoch": 1,
    "created_clock": 0
  }
}

If accounts are disabled, the response is {"account":null}.

Admit one text observation as a node.

curl -sS "$GNOMON_API_URL/v1/observe" -H "Authorization: Bearer $GNOMON_TOKEN" -H "Content-Type: application/json" --data '{"text":"the sky is blue"}'

{"node":"<16-hex-invariant>"}

The returned hash is the node identity. The text is an epithet, not the key.

Admit an ordered sequence and wire consecutive nodes as directed transitions.

curl -sS "$GNOMON_API_URL/v1/observe-seq" -H "Authorization: Bearer $GNOMON_TOKEN" -H "Content-Type: application/json" --data '{"epithets":["sky","blue"]}'

{"nodes":["<hash>","<hash>"]}

{"text":"sky blue"} is split on whitespace. epithets preserves any spaces inside an item.

Emit from a query string or an existing node hash.

curl -sS "$GNOMON_API_URL/v1/query" -H "Authorization: Bearer $GNOMON_TOKEN" -H "Content-Type: application/json" --data '{"query":"sky","payload_kind":"text"}'

{"emitted_text":"..."}

If query is not an existing hash, it is admitted as a new observation before emission. Querying unknown text mutates the instance. Use /emit for an anchor-only read.

Emit from an existing anchor without admitting anything.

curl -sS "$GNOMON_API_URL/v1/emit" -H "Authorization: Bearer $GNOMON_TOKEN" -H "Content-Type: application/json" --data '{"node":"<node-hash>","mode":"nlc_v2","max_steps":15}'

{"verdict":"...","emitted_text":"..."}

An unknown anchor returns HTTP 200 with verdict and emitted_text set to UNKNOWN_SEAM. It does not create the node.

Reconstruct a justification and optionally promote the derived edge.

curl -sS "$GNOMON_API_URL/v1/derive" -H "Authorization: Bearer $GNOMON_TOKEN" -H "Content-Type: application/json" --data '{"query":"sky","target":"blue","payload_kind":"proof","learn":false}'

{"promoted":false}

The HTTP response reports promotion only. It does not include the derivation, proof, sigil, or structure digest; those are available through the Python engine.

query and target are admitted if they are not existing hashes.learn:false avoids promotion but still runs the derivation.