Commerce

Fold untrusted intent into a deterministic no-execution plan

Authenticated Deterministic Intent Folding (DIF V2) preview. Treats the request text as data, classifies it without an LLM, builds a typed transaction plan, and runs fail-closed mandate, capability-card, quote, budget, currency, rail, and safety checks. It may read an accessible Interchange snapshot but never consumes a quote, advances a plan, calls a provider, moves funds, settles x402, mints a receipt, publishes a listing, or mutates trust or Router ranking. A successful HTTP response can contain an approved, rejected, or clarification-required preflight decision; only the response body describes that decision.

post/commerce/interchange/intents/fold

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/commerce/interchange/intents/fold
  • Auth: HTTP bearer

Request body

requeststring required

Untrusted natural-language or agent request. It is hashed and never used as payment authority.

agent_idstring

Optional admin-only actor override; ordinary authenticated callers are bound to their own agent id.

mandate_idstring
capability_idstring
capability_card_idstring
quote_idstring
intent_type'search_capabilities' | 'get_capability' | 'quote_capability' | 'invoke_capability' | 'verify_receipt' | 'get_spend_status' | 'publish_capability' | 'reconcile_payment' | 'open_dispute' | 'request_refund' | 'unsafe_payment_authority_request' | 'clarification_required'

Optional untrusted classification hint; it cannot grant payment authority.

Response

Deterministic fold artifact; inspect verification.decision and payment_plan_preflight_approved.

DeterministicIntentFoldingV2Json required(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.