Skip to main content
POST
Evaluate an agent action

Authorizations

Authorization
string
header
required

A VisIQ API key presented as Authorization: Bearer vq_prod_.... Mint keys under Connectors -> API Keys in the dashboard.

Body

application/json
agent_id
string
required
Required string length: 1 - 255
target_app
string
required
Required string length: 1 - 255
action
string
required
Required string length: 1 - 255
context
object

Arbitrary decision inputs (e.g. amount, resource id).

session_id
string
Required string length: 1 - 255
telemetry
object

Response

The enforced decision.

decision_id
string<uuid>
required
decision
enum<string>
required
Available options:
permit,
deny,
approval_required,
mask
reason
string
required
enforced
boolean
required
agent_mode
enum<string>
required
Available options:
off,
monitor,
enforce
rule_code
string | null

The matched rule code (synthetic D-* for defaults; null in off-mode).

plane
enum<string> | null
Available options:
action,
retrieval,
delegation,
null
operation
string | null
is_retrieval
boolean
arg_redaction_rules
object[]

Present only when decision is mask.

hitl_fallback
enum<string>

Present only when decision is approval_required — the fallback if no human responds.

Available options:
mask,
deny