🌐 REST API & Runtime Parameters Reference¶

Complete parameter dictionary for developers integrating with the Spector Synapse REST API. Outlines required and optional HTTP request headers, JSON body payloads, query parameters, data types, validation rules, and cognitive scoring parameters.

1. HTTP Headers & Authentication¶

All requests to Spector Synapse must include appropriate headers for content negotiation and tenant security:

2. Memory Operations Endpoints¶

POST /api/v1/memory/remember¶

Ingests and memorizes new text content, generating embeddings, computing initial ICNU importance, and establishing synaptic graph linkages.

JSON Body Parameters¶

Request Example¶

curl -X POST http://localhost:7070/api/v1/memory/remember \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The production database maintenance window is scheduled for Sunday 02:00 UTC.",
    "tier": "SEMANTIC",
    "source": "USER_STATED",
    "tags": "infra, maintenance, schedule",
    "urgency": 0.85,
    "interest": 0.50
  }'

POST /api/v1/memory/recall¶

Performs multi-stage cognitive retrieval, combining vector similarity, BM25 keyword matching, synaptic tag filtering, associative Hebbian graph expansion, and Ebbinghaus decay scoring.

JSON Body Parameters¶

Request Example¶

curl -X POST http://localhost:7070/api/v1/memory/recall \
  -H "Content-Type: application/json" \
  -d '{
    "query": "When is the next database maintenance window?",
    "topK": 5,
    "depth": 2,
    "tags": ["infra", "maintenance"],
    "scoringMode": "COGNITIVE",
    "recallMode": "LEARN"
  }'

POST /api/v1/memory/search¶

Pure vector nearest-neighbor search, bypassing the 6-phase cognitive scoring pipeline and graph traversal.

JSON Body Parameters¶

GET /api/v1/memory/browse & /table¶

Paginated inspection endpoint designed for data tables and administrative explorer views.

URL Query Parameters¶

POST /api/v1/memory/reflect¶

Triggers an on-demand cognitive reflection sweep to cluster recent episodic memories and synthesize semantic generalizations.

JSON Body Parameters¶

3. Targeted Lifecycle & Feedback Endpoints¶

POST /api/v1/memory/reinforce/{id}¶

Applies positive or negative emotional feedback to an existing memory, adjusting its valence and storage strength (\(S\)).

• Path Parameter: id — Unique memory identifier.
• Request Body:

  {
    "valence": 50
  }
  

  valence is an integer between -128 (strong negative punishment) and +127 (strong positive reward).

POST /api/v1/memory/suppress/{id}¶

Suppresses a memory from being recalled during normal queries or restores a previously suppressed memory.

• Path Parameter: id — Unique memory identifier.
• Request Body:

  {
    "action": "SUPPRESS",
    "reason": "Information superseded by customer policy update."
  }
  

  action can be either SUPPRESS or UNSUPPRESS.

POST /api/v1/memory/resolve/{id}¶

Flags an unresolved question, goal, or prospective task memory as completed.

• Path Parameter: id — Unique memory identifier.
• Request Body:

  {
    "resolved": true
  }
  

POST /api/v1/memory/vacuum¶

Surveys a memory tier and reports how many records are live versus tombstoned.

• Request Body:

  {
    "tier": "SEMANTIC"
  }
  

4. Multi-Tenant Namespace Parameters¶

Spector supports isolated multi-tenant memory spaces managed via the /api/v1/namespaces endpoints: