v1

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-1410115.6 KB

intents

Evaluate an intent against policies

Submits a proposed value-moving action for evaluation against the policy engine. Returns the verdict (PASS, DENY, or PENDING_APPROVAL), detailed per-policy results, and a cryptographic receipt hash. If PASS, the intent is auto-settled. If PENDING_APPROVAL, an approval request is queued for human review.

post/v1/intents/evaluate

Request body

intentIdstring required

Unique intent identifier

agentstring required

Agent wallet address or identifier

requesterstring required

Wallet funding this action

recipientstring required

Destination wallet for settlement

amountstring required

Amount in token base units (6 decimals for USDC)

actionTypenumber required

Action classification: 0=api_payment, 1=reward, 2=treasury

mintstring

SPL token mint address

Example request

{
  "intentId": "intent-001-abc",
  "agent": "DemoAgent",
  "requester": "DemoRequester",
  "recipient": "DemoRecipient",
  "amount": "3000000",
  "mint": "USDC"
}

Response

Intent evaluated successfully

verdict'PASS' | 'DENY' | 'PENDING_APPROVAL'

intentIdstring

idstring uuid

receiptHashstring

amountstring

statusstring

Example response

{
  "amount": "3.00"
}