> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reilabs.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Explain memory

> Returns the structured non-LLM reasoning view: evidence, hypotheses, causal chain, reasoning edges, discovered connections, conflicts, and predicted/missing observations. `score` is a bounded ranking/support score for UI ordering. `confidence` is a capped mechanistic support score, not a calibrated probability.



## OpenAPI

````yaml /neuroadapt-openapi.json post /api/v1/memory/explain
openapi: 3.0.3
info:
  title: Neuroadapt API
  version: 1.0.0
  description: >-
    Neuroadapt is a local, non-LLM memory and reasoning API exposed through an
    authenticating go-proxy. It stores session-scoped events, retrieves relevant
    evidence, exposes concept-level reasoning signals, and keeps enough state
    for frontend clients to inspect what the system knows.


    ## Authentication


    Send `Authorization: Bearer <secretToken>`. The proxy looks the token up in
    the MongoDB `agents` collection and **forces `session_id = agentId` on every
    request**. Any `session_id` you put in the body (or in the
    `/memz/memories/{session_id}` path) is overwritten by the proxy, so the
    value you send is a placeholder. A missing or invalid token returns `401`.


    The core memory endpoints do not call an LLM; the OpenAI-compatible chat
    route is present only for compatibility.


    ## API prefix


    The versioned API is served under `/api/v1`. Equivalent bowtie-compatible
    prefixes are also available: `/public/rei-ai-bowtie/v4` and
    `/rei-ai-bowtie/v4`.
servers:
  - url: https://rei-neuroadapt-api.reilabs.org
    description: UAT (proxied, authenticated)
security:
  - BearerAuth: []
tags:
  - name: System
    description: >-
      Health and version checks. Public — no auth required (passed through by
      the proxy).
  - name: Memory
    description: Session-scoped, non-LLM memory and reasoning endpoints (/api/v1/memory/*).
  - name: Domains
    description: >-
      Closed-source expansion surface. Declare schemas, rules, events, queries,
      and feedback over HTTP (/api/v1/domains/*).
  - name: Legacy
    description: Low-level memory API (/memz/*).
  - name: Chat
    description: >-
      OpenAI-compatible chat completion route. Use only when you explicitly want
      the chat pipeline.
paths:
  /api/v1/memory/explain:
    post:
      tags:
        - Memory
      summary: Explain memory
      description: >-
        Returns the structured non-LLM reasoning view: evidence, hypotheses,
        causal chain, reasoning edges, discovered connections, conflicts, and
        predicted/missing observations. `score` is a bounded ranking/support
        score for UI ordering. `confidence` is a capped mechanistic support
        score, not a calibrated probability.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - user_message
              properties:
                session_id:
                  type: string
                  description: Placeholder — overwritten by the proxy.
                user_message:
                  type: string
                top_k:
                  type: integer
                  default: 10
                metadata_filter:
                  type: object
                  additionalProperties: true
                  nullable: true
            example:
              session_id: ignored
              user_message: Where does Alice work?
              top_k: 10
              metadata_filter: null
      responses:
        '200':
          description: Structured reasoning explanation.
          content:
            application/json:
              schema:
                type: object
              example:
                session_id: agent-id
                query: Where does Alice work?
                explanation:
                  evidence:
                    - memory_id: memory-uuid
                      content: Alice works at Reilabs and lives in Singapore.
                      summary: Alice works at Reilabs...
                      score: 0.57
                      matched_concepts:
                        - alice
                        - reilabs
                      metadata:
                        source: http-test
                      phase: buffer
                  seed_concepts:
                    - alice
                    - reilabs
                  activated_concepts: []
                  reasoning_edges: []
                  discovered_connections: []
                  conflicts: []
                  resolution: {}
                  hypotheses: []
                  causal_chain: []
                  predicted_next_observations: []
                  missing_observations: []
                  neurosymbolic:
                    enabled: true
                    used: true
                    reasoning_mode: hybrid
                  graph_stats:
                    total_nodes: 0
                    total_edges: 0
                    total_hyperedges: 0
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            type: object
          example:
            detail: Unauthorized
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Unit API Key mapped to an agent in the `agents` collection. The proxy
        forces `session_id = agentId`.

````