memory

Feedback

Report outcome for atoms (success/failure). Updates valence and Hebbian weights.

post/api/v1/memory/feedback

Request

  • Base URL: https://core.mnemoverse.com
  • URL: https://core.mnemoverse.com/api/v1/memory/feedback
  • Auth: one of:
    • API key in header X-Api-Key
    • HTTP bearer

Request body

atom_idsstring[] required

UUIDs of atoms to update with this outcome.

outcomenumber required

Outcome signal: -1 (failure) to +1 (success).

conceptsstring[]

Concepts to reinforce (Hebbian) with this outcome.

query_conceptsstring[]

Concepts from the original query (from read result query_concepts). Enables feedback-driven co-activation: links query concepts with used atom concepts, modulated by outcome signal (stigmergy).

domainstring

Domain for the feedback.

Example request

{
  "atom_ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "concepts": [
    "rotation",
    "symmetry"
  ],
  "domain": "arc",
  "outcome": 0.8
}

Response

Successful Response

updated_countinteger required

Number of atoms whose valence was updated. SYNC mode (feedback_async=False): the real count of atoms that actually existed and were updated (missing atom_ids are skipped). ASYNC mode (feedback_async=True): a best-effort ACCEPTED-count estimate — the number of atom_ids submitted — since the authoritative count isn't known until the background worker runs.

avg_valencenumber required

Average valence of updated atoms after the update. SYNC mode: the real post-update average. ASYNC mode: always 0 in the enqueue ack (the value is computed later on the worker, not returned here).

coactivation_edgesinteger

Number of Hebbian edges created/updated by feedback-driven co-activation. SYNC mode: the real edge count. ASYNC mode: always 0 in the enqueue ack (computed later on the worker).

feedback_time_msnumber nullable

Server wall time of the feedback pipeline in ms (TRACING_SPEC §4). Optional in the schema for client back-compat but always populated by the route.

Changes

No recorded changes to this operation across all 1 revision of this API.