Submit Feedback
Tell MemorySync whether a memory was useful. By default this moves the memory's importance, which is a weighted retrieval-ranking factor.
Endpoint and request fields
| Field | Type | Contract |
|---|---|---|
signal | string | Required. One of positive, negative, retrieved, ignored. |
comment | string | Optional note, up to 1000 characters. |
What each signal means
| Signal | Meaning | Effect |
|---|---|---|
positive | The memory was useful. | Raises importance. |
negative | The memory was wrong or unhelpful. | Lowers importance, and by more than a positive raises it. |
retrieved | It was shown to the user. | A weak positive. |
ignored | It was shown but not used. | A weak negative. |
Negative moves further than positive on purpose: a wrong memory should stop appearing faster than a useful one climbs.
Submit a signal
import osfrom memorysync import MemorySyncClientclient = MemorySyncClient(api_key=os.environ["MEMORYSYNC_API_KEY"],base_url="https://api.memorysync.io",project_id=os.environ["MEMORYSYNC_PROJECT_ID"],end_user_id="usr_7f3a9c2e",)result = client.feedback(101, "positive", comment="exactly what I needed")print(result.importance_before, "->", result.importance_after)
Response shape
{"memory_id":101,"signal":"positive","importance_before":0.5,"importance_after":0.53,"adjustment":0.03,"influenced_ranking":true,"summary":{"total_signals":1,"signal_counts":{"positive":1,"negative":0,"retrieved":0,"ignored":0},"trend":{"momentum":"positive","consistency":1.0,"trend_multiplier":1.5,"recent_count":1}}}
| Field | Meaning |
|---|---|
adjustment | The delta actually applied. 0.0 when ranking influence is disabled, or when the change was clamped away at the bounds. |
influenced_ranking | Whether this signal was allowed to change ranking. Reported rather than assumed, because it is configurable. |
summary.trend.trend_multiplier | How much the base adjustment was amplified or damped. |
The adjustment is adaptive, not fixed
A consistent run of the same signal amplifies the move, a burst of activity amplifies it further, and mixed signals damp it. A signal that contradicts a strong recent trend is applied cautiously. So the tenth positive signal moves importance more than the first, and the response reports exactly what was applied.
Importance is clamped
Billing
Not billed. Feedback is neither an add nor a retrieval, so it never counts against a plan allowance.
Errors and next action
A 400 means the signal is not one of the four valid values; the response names them. A 404 means the memory is not visible in this scope. A rejected signal changes nothing and records nothing.