Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sage-f6b5014e.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
GET /events

Returns the behavioral event history for a vault — an append-only record of every decision the pipeline made. Useful for auditing and for the agent to summarize recent activity. 
curl -s -H "Authorization: Bearer $AGENT_SECRET" \
  "https://api.trysage.xyz/events?vault=VAULT_ADDRESS&limit=50"
Query paramRequiredDescription
vaultYesVault address
limitNoMax events to return

​
Event Types

OutcomeRecorded when
auto_approvedProposal scored below the approve threshold
sent_for_reviewProposal scored in the REVIEW band
auto_blockedProposal scored at or above the block threshold
executedProposal co-signed and confirmed on-chain
rejectedProposal rejected by the owner
Each event carries the proposal reference plus the riskScore, riskVerdict, riskReasons, and any triggeredRules captured at decision time — so every score and reason stays traceable after the fact.
/events is a public read endpoint. Pair it with /transactions for full proposal detail.