Skip to main content
GET
Guardrail Invocations
Recent tracectrl.guardrail.evaluation spans for a specific (agent_id, guardrail_name) pair, ordered newest first. Reads directly from otel_traces and does not depend on the analytics pipeline tick.

Query Parameters

string
required
The agent that owns the guardrail.
string
required
The guardrail to query.
integer
default:"50"
Maximum rows to return.
Returns 400 if agent_id or guardrail_name is missing.

Response

Array of GuardrailInvocation objects:
string
Trace ID of the evaluation span
string
Span ID of the evaluation span
string
ISO-8601 timestamp
string
pass, fail, or error
string
pre_input or post_output
string
Judge’s reasoning
string
Evidence captured at evaluation time
string
Severity level
string
judge_llm or protector_plus
string
Model used for the decision
string
Structured response payload (Protector Plus only; empty for legacy judge_llm spans)