Skip to main content
A quality observation on a context trace or on a fact. Every observation is stored (table feedback, migration 0006).
​
string
required
1 to 128 characters.
​
uuid
Exactly one of trace_id / fact_id is required (enforced by a Pydantic model_validator).
​
uuid
​
string
required
"useful" · "irrelevant" · "incorrect".
​
string
Max 2000 characters.
A rating="incorrect" on a fact_id transitions the fact to disputed (if the transition is legal from its current status — see the transition graph). A disputed fact is never served as active by the Context Assembler again.

​
Response — 201 Created

​
string
default:"recorded"
​
uuid
required
​
string | null
The fact’s resulting status, if the target was a fact_id; null otherwise.

​
Possible errors

fact_not_found (404 — unknown fact_id, or from another project: same error, no leak), invalid_payload (422 — neither or both of trace_id/fact_id, or rating outside the enum).