Skip to main content
POST
Evaluate policy against tools

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Body

application/json
policy
object
required

A complete CLPI policy document defining capability mappings, forbidden tools, escalation triggers, and enforcement defaults.

tools
string[]
required

List of tool identifiers to evaluate against the policy

agent_id
string

Optional agent ID to include agent-specific context in evaluation

Response

Policy evaluation result

Result of evaluating a CLPI policy against a set of tools or traces.

verdict
enum<string>

Overall evaluation verdict

Available options:
pass,
warn,
fail
violations
object[]

List of policy violations detected

warnings
object[]

Non-blocking warnings about potential issues

card_gaps
object[]

Gaps between the policy and the alignment card

coverage
number

Fraction of tools covered by the policy (0.0 to 1.0)

Required range: 0 <= x <= 1