Authorization: Bearer <key> / ?apikey= depending on your client.
Authentication
Main endpoints
Health
postgres in production).
Create mandate
agent_id, domain, owner_signature.
Response includes id, status, and apiKey (mandate key — once).
Check (decision)
- a normalized action (
agent_id,domain,action_type,value, …), or - a protocol envelope (
protocol:raw|ap2|vi|acp|spt+ credential/session).
KYI normalizes and crypto-verifies (AP2/VI) on the server, then runs Cedar.
Merchant verify
mandate_id (or mandate API key). Same body shapes as /decisions.Re-checks the cart/intent against the mandate and returns ALLOW/DENY + receipt (merchant shield).
List mandates (dashboard)
Via User-Service (authenticated dashboard user):List decisions for a mandate
Public receipt key (auditors)
Fetch receipt by id (auditors)
Verdict values
Common reason codes
SDK vs REST
Prefer@abstraxn/warrant for TypeScript backends — it handles canonicalization, seals, and error defaults.
See SDK quickstart.