API / pre-execution verdict

Aurel API reference

Use Aurel to verify intent before an autonomous agent executes a high-consequence action. The API returns a decision, risk score, triggered layer, and signed audit data.

POST /api/v1/verify

Authenticates with the x-api-key header. Use this endpoint before passing an agent decision into a downstream tool. Payments are the first supported example.

curl -X POST https://aurel.io/api/v1/verify \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "intent_id": "act_2026_0001",
    "agent_id": "ag_expense_manager_v1",
    "amount": 250,
    "currency": "USD",
    "recipient": "billing@stripe.com",
    "agent_context": "Renewing approved SaaS subscription.",
    "mission_scope": "Manage SaaS renewals up to $500/month",
    "metadata": { "action_type": "payment" }
  }'

Response

{
  "intent_id": "act_2026_0001",
  "decision": "allow",
  "reason": "All verification layers passed",
  "risk_score": 5,
  "triggered_rule": null,
  "evaluated_at": "2026-07-11T12:00:00.000Z",
  "audit_signature": "8f1c...",
  "audit_signature_version": "audit-v1-hmac-sha256"
}

Decision values

allow: The action can proceed.
flag: The action requires review or escalation.
block: The action should not execute.