Skip to main content

Dry-run evaluate a guardrail

POST 
/api/v1/guardrails/:guardrail_id/evaluate

Runs the full evaluation pipeline — the class expression, the guard, the context tool per context_mode, live soat.* resolution — against caller-supplied args and guardrail_context, and returns the exact guardrail_evaluation record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional tool_id to resolve soat.tool.*.

Request​

Responses​

The would-be evaluation record (nothing executed)