Skip to main content
POST
Evaluate an agent's derived policy against tools

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Body

application/json
agent_id
string
required

Agent whose canonical alignment card the policy is derived from. Must have a published canonical card, and the caller must be a member of the agent's org (else 404, the same answer as an agent that does not exist).

tools
object[]
required

Non-empty list of tools to evaluate against the agent's derived policy.

Minimum array length: 1
context
string
default:cicd

Evaluation surface/context (default "cicd").

dry_run
boolean
default:false

When true, the evaluation result is not persisted to policy_evaluations.

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