Evaluate a governed event (unified)
The single, operation-native evaluation endpoint. Declare which operations the event performs via operations[] and receive the union decision vocabulary. Hybrid events (e.g. ["retrieval","action"]) are evaluated on both facets and combined fail-closed to the most restrictive outcome. A legacy { kind: "action" | "retrieval", ... } shape is also accepted for compatibility.
Requires scope rules:evaluate (dual-accepts the legacy allow:write / recall:write).
Authorizations
A VisIQ API key presented as Authorization: Bearer vq_prod_.... Mint keys under Connectors -> API Keys in the dashboard.
Body
The operation-native request. Include action fields (target_app, action) when operations contains action or delegation; include retrieval fields (resource_type, ...) when it contains retrieval. A legacy { kind: "action" | "retrieval", ... } body is also accepted.
1 - 3 elementsaction, retrieval, delegation 1 - 2551 - 2551 - 255retrieve, tool_call, prompt_render 1 - 255641284000Response
The unified decision. results[] is present for hybrid events.
For single-facet events the top-level fields carry the projected decision. For hybrid events, decision is the most-restrictive outcome and results[] carries the per-operation breakdown.
action, retrieval, delegation permit, deny, approval_required, redact, escalate, mask The originating facet's verbatim decision word (single-facet responses).
off, monitor, enforce, null Present for hybrid events — one entry per evaluated operation.