Skip to main content
POST
Check Guardrail
Records your application’s score for an agent’s input or output. It does not scan raw text or calculate an independent safety score. Supply the score produced by your own detector. The required fields are agent_id, check_type, and guardrail_type. check_type must be input or output. The current handler treats an omitted score as zero. Always send an explicit score; a pass result does not establish that content is safe. A failed check attempts to open the agent’s circuit breaker. content_hash is metadata, not uploaded content for analysis. The current receipt uses a system marker in its signature field; do not treat it as cryptographic proof.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
agent_id
string<uuid>
required

Agent requesting the action

check_type
string
required
guardrail_type
string
required
content_hash
string
details
any
execution_id
string | null
metadata
any
score
number

Response

Guardrail check result

allowed
boolean
violations
object[]
receipt_id
string<uuid>