Evaluate an agent action
Evaluation
Evaluate an agent action
Evaluate a single agent action against your action-governance rules and return the enforced decision. This is the agent-facing hot path.
Requires scope rules:evaluate (or the legacy allow:write).
POST
Evaluate an agent action
Authorizations
A VisIQ API key presented as Authorization: Bearer vq_prod_.... Mint keys under Connectors -> API Keys in the dashboard.
Body
application/json
Response
The enforced decision.
Available options:
permit, deny, approval_required, mask Available options:
off, monitor, enforce The matched rule code (synthetic D-* for defaults; null in off-mode).
Available options:
action, retrieval, delegation, null Present only when decision is mask.
Present only when decision is approval_required — the fallback if no human responds.
Available options:
mask, deny