Policy

Evaluate an agent's derived policy against tools

Evaluate a list of tools against the policy DERIVED from the agent's published canonical alignment card (capabilities + enforcement + escalation triggers). Returns a verdict with detailed violations, warnings, card coverage gaps, and overall coverage percentage. Requires a published canonical card for the agent (PUT /v1/agents/{id}/alignment-card first, else 404). No standalone policy document is accepted — the card is the source of truth (UC-8). agent_id must be a string naming an agent the caller may read (cards:read); an agent outside the caller's org gets the same 404 as an unknown agent.

post/policies/evaluate

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/policies/evaluate
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key

Request body

agent_idstring 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).

contextstring

Evaluation surface/context (default "cicd").

dry_runboolean

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

Response

Policy evaluation result

verdict'pass' | 'warn' | 'fail'

Overall evaluation verdict

coveragenumber

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

Changes

No recorded changes to this operation across all 1 revision of this API.