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 /transactions

Lists proposals for a vault. Filter client-side for in-review items where inReview === true and status is neither executed nor rejected. 
curl -s -H "Authorization: Bearer $AGENT_SECRET" \
  "https://api.trysage.xyz/transactions?vaultAddress=VAULT_ADDRESS"
Query paramRequiredDescription
vaultAddressYesVault address to list proposals for

​
GET /transactions/:id

Fetch a single proposal, including its stored risk verdict. Returns: riskScore, riskVerdict, riskReasons, inReview, status, txSignature, and transfer details.

​
PATCH /transactions/:id

Reject a proposal or flag it for manual review. Use latest as the id with a vaultAddress to target the most recent in-review proposal.

​
Reject

{ "action": "reject", "reason": "Rejected by owner" }

​
Mark for review

{ "action": "review", "reason": "Flagged for manual review" }
FieldTypeRequiredDescription
actionstringYesreject or review
reasonstringNoHuman-readable reason recorded on the proposal
vaultAddressstringWhen id=latestResolves the latest in-review proposal
After a reject, call POST /notify-resolve to update the Telegram message.