Skip to main content
POST
Ingest Agent Trace

Authorizations

X-API-Key
string
header
required

PromptGuard API key for developer endpoints. Keys start with pg_live_ and are created in the dashboard.

Headers

x-api-key
string | null

Body

application/json

A full agent execution trace to audit post-hoc.

Unlike /validate-tool (a pre-execution check of a single tool name + args), this carries the whole chronological trace with tool outputs plus the user's original objective, so the value-level dataflow-taint and goal-alignment detectors can fire.

user_objective
string
default:""
events
AgentTraceEvent · object[]
tool_labels
Tool Labels · object | null

Response

Successful Response

Aggregated verdict over the ingested trace.

decision
string
required
event_id
string
required
findings
AgentTraceFinding · object[]