API: Policy

Dry-run policy

POST /v1/policies/check

Checks whether a payment would pass without moving funds.

Request

{
  "agentId": "researchbot-01",
  "service": "risk-report-api",
  "amount": "0.30",
  "asset": "USDC",
  "reason": "Preview larger report"
}

Response

{
  "allowed": false,
  "reason": "max_per_payment_exceeded",
  "message": "0.30 USDC is above the 0.25 USDC max payment limit",
  "policyRevision": "polrev_18",
  "wouldRequireApproval": false
}

Field	Type	Description
allowed	boolean	Whether settlement would be approved.
reason	string	Policy rule that decided the outcome.
wouldRequireApproval	boolean	True when payment crosses human approval threshold.

See Policy schema for every field a policy document can set.