Skip to main content

FeedbackRequest

Request body for POST /feedback/decision.

timestamp is the ISO 8601 UTC timestamp of the original decision. A decision record must exist for (condition_id, condition_version, entity, timestamp) — the route handler raises HTTP 404 if not found.

note is free-text, may contain PII — never log it.

condition_idCondition Id (string)required
condition_versionCondition Version (string)required
entityEntity (string)required
timestampTimestamp (string)required
feedbackFeedbackValue (string)required

Valid feedback values for a decision.

false_positive — condition fired but should not have → tighten false_negative — condition did not fire but should have → relax correct — expected behaviour → no calibration adjustment

Invalid aliases that must be rejected: 'useful', 'not_useful' — these are NOT valid values.

Possible values: [false_positive, false_negative, correct]

note object
anyOf
string
FeedbackRequest
{
  "condition_id": "string",
  "condition_version": "string",
  "entity": "string",
  "timestamp": "string",
  "feedback": "false_positive",
  "note": "string"
}