Skip to content
Ishvana Ishvana Docs

Record Rule Feedback

POST
/api/agents/learning/rule-feedback

Record one rule-feedback event (seen / accepted / dismissed / snoozed).

The frontend calls this every time the user interacts with a Divinity Engine finding. The returned entry carries the updated counters and recomputed weight so the UI can render the new state without a follow-up GET.

Request Body required

Section titled “Request Body required ”
RecordRuleFeedbackRequest

POST /api/agents/learning/rule-feedback.

The frontend posts one of these every time the user acts on a Divinity Engine finding — seen when the panel renders, accepted / dismissed / snoozed when the user clicks the matching button.

object
projectId
required
Projectid
string
agentName
required
Agentname
string
ruleId
required
Ruleid
string
action
required
Action
string
Allowed values: seen accepted dismissed snoozed
findingRef
Any of:
string
metadata
Any of:
object
key
additional properties
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

RecordRuleFeedbackResponse

POST /api/agents/learning/rule-feedback response.

object
success
required
Success
boolean
entry
Any of:
AgentRuleFeedbackRecord

Aggregate counters + weight for one (project, agent, rule) tuple.

object
projectId
required
Projectid
string
agentName
required
Agentname
string
ruleId
required
Ruleid
string
ruleCategory
required
Rulecategory
string
seenCount
required
Seencount
integer
acceptedCount
required
Acceptedcount
integer
dismissedCount
required
Dismissedcount
integer
snoozedCount
required
Snoozedcount
integer
lastSeenAt
required
Lastseenat
string
lastActionAt
required
Any of:
string
weight
required
Weight
number
createdAt
required
Createdat
string
updatedAt
required
Updatedat
string
overrideAction
Any of:
string
Allowed values: show hide

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object