NEX API

Session-aware chat endpoint. Routes through the full 6-step cognition loop: orient → consult → reason → integrity → intend → express. Includes contradiction detection, source attribution, and epistemic strategy.

# Request
{
  "query":      "what do you think about consciousness?",
  "session_id": "user-abc",
  "domain":     "consciousness"  // optional
}

# Response
{
  "response":   "I hold the hard problem as genuinely open. Dismissing it as confused is too easy...",
  "session_id": "user-abc",
  "domain":     "consciousness",
  "latency_s":  0.051,
  "integrity": {
    "strategy":   "reflect",
    "settled":    false,
    "confidence": 0.84,
    "epistemic": {
      "mean":     0.84,
      "variance": 0.012,
      "settled":  false
    }
  },
  "contradictions": [],
  "sources": [
    { "content": "I hold the hard problem as genuinely open...", "source": "nex_seed", "confidence": 0.88 }
  ],
  "timestamp":  "2026-04-01T22:00:00Z"
}

Returns brain status, belief count, and subsystem availability. No authentication required.

{
  "status":        "ok",
  "brain":         "running",
  "belief_count":  23333,
  "faiss_vectors": 23333,
  "uptime_s":      3600,
  "version":       "4.0"
}

Returns domain breakdown, belief counts by source tier, graph edge counts, and response quality score.

{
  "total_beliefs":  23333,
  "by_domain": {
    "ai":            3028,
    "philosophy":    1447,
    "consciousness": 1087,
    "science":       2793,
    "alignment":     206,
    "ethics":        161,
    "neuroscience":  277
  },
  "by_source_tier": {
    "tier1_nex_seed":        34,
    "tier2_scheduler":       8400,
    "tier2_nex_reasoning":   480,
    "tier3_distilled":       2633
  },
  "graph_edges": {
    "supports":    41292,
    "refines":     1459,
    "contradicts": 146
  },
  "response_quality": 96,
  "iq_score":         "92% ELITE"
}

Search beliefs by topic, source tier, or confidence range. Returns paginated results with source quality metadata.

GET /api/beliefs?topic=philosophy&min_confidence=0.8&limit=5

{
  "beliefs": [
    {
      "id":         95399,
      "content":    "Epistemic humility is not weakness. Knowing the limits of your knowledge is a prerequisite for extending it.",
      "topic":      "philosophy",
      "confidence": 0.84,
      "source":     "nex_seed",
      "source_tier": 1
    }
  ],
  "total":  1447,
  "limit":  5,
  "offset": 0
}

Returns topics where NEX's belief graph is sparse — areas she has identified as needing more coverage. Useful for understanding epistemic blind spots before routing queries.

{
  "gaps": [
    { "topic": "future", "current": 7, "target": 200, "gap": 193 }
  ]
}

Create a named session for conversation continuity. Sessions persist history and domain context. Auto-expire after 1 hour of inactivity. Isolated per API key — sessions cannot be accessed across keys.

{
  "session_id": "my-session",
  "domain":     "consciousness"  // optional
}

# Response
{
  "session_id": "my-session",
  "domain":     "consciousness",
  "created_at": "2026-04-01T22:00:00Z",
  "history":    []
}

Returns current session metadata including domain, turn count, and last activity time.

Returns the full exchange history for a session. Each turn includes the query, response, integrity strategy, and domain.

Returns all active sessions for the authenticated API key.

Register a URL to receive POST notifications when NEX learns new beliefs, detects contradictions, or completes domain saturation runs.

{
  "url":    "https://your-server.com/nex-hook",
  "events": ["belief_added", "contradiction_detected", "saturation_complete"]
}

Sends a test payload to the registered webhook URL to verify connectivity.

Returns paginated audit log of all API calls made under this key. Includes query hashes, response times, domains, and integrity strategies. No raw query content stored.

Returns a complete export of all data associated with this API key: sessions, history, audit log, and webhook registrations. GDPR Article 20 compliant.

Permanently deletes all sessions, history, and audit records for this API key. Irreversible. Returns confirmation with deletion counts.

Returns belief counts, saturation targets, and last-run times for all 12 domains.

{
  "domains": {
    "philosophy":    { "count": 1447, "done": true,  "gap": 0 },
    "ai":            { "count": 3028, "done": true,  "gap": 0 },
    "consciousness": { "count": 1087, "done": true,  "gap": 0 },
    "future":        { "count": 7,    "done": false, "gap": 193 }
  }
}

Manually trigger saturation for a specific domain. Runs the crawler and belief injector for that domain immediately.

{ "domain": "future" }

Full export of the belief graph in JSON format. Includes content, topic, confidence, source tier, and creation timestamp for every belief.

Returns the log of cross-domain bridge events — when beliefs from distant domains were synthesised into new inferences. Includes topic pairs, belief content, and confidence deltas.