Skip to content
Ishvana Ishvana Docs

Set Rule Override

POST
/api/agents/learning/rule-overrides

Pin a rule to "show" or "hide" for a (project, agent, rule).

The Divinity Engine’s utility scorer reads these overrides on every scan via :func:override_factor and applies a multiplicative boost (show: 2x) or damper (hide: 0.05x) so the user’s pin lands above or below same-severity peers regardless of severity ordering.

Request Body required

Section titled “Request Body required ”
SetRuleOverrideRequest

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

Pins a rule to "show" or "hide" for the given (project, agent, rule_id). Idempotent — repeated calls with the same action are no-ops; calls with a different action flip the pin in place.

object
projectId
required
Projectid
string
agentName
required
Agentname
string
ruleId
required
Ruleid
string
action
required
Action
string
Allowed values: show hide

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

SetRuleOverrideResponse

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

object
success
required
Success
boolean

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