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

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

Response

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