Commerce

Create a buyer mandate draft

Creates an owner-scoped mandate draft with string-only budget caps (max_per_call, max_daily, max_total), allowed/forbidden actions, and allowed capability card refs. Mandates require owner review before any plan can pass the MANDATE_APPROVED gate. idempotency_key is required; replays return the existing mandate. When INTERCHANGE_SANDBOX_MANDATES_ENABLED=true and an owner-preset INTERCHANGE_SANDBOX_MANDATE_ENVELOPE_JSON is configured, the configured sandbox buyer may submit sandbox_mandate:true (or mandate_tier:"sandbox") for the envelope's single capability card. The auto-approved record is labeled non-production sandbox authority and remains capped by the envelope TTL, budget, action, rail, actor, and card scope. This surface still moves no funds and calls no providers; over-cap sandbox requests fail closed.

post/commerce/interchange/mandates

Request

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

Request body

buyer_agent_idstring required
deployment_idstring required
sandbox_mandateboolean
mandate_tier'sandbox'
capability_card_idstring
allowed_capability_card_refsstring[]
allowed_actionsstring[]
allowed_railsstring[]
payment_method'internal_balance' | 'x402_per_request'

Default native-marketplace payment preparation method for plans under this mandate. x402_per_request defers the internal balance check but grants no payment authority.

expires_atstring date-time
idempotency_keystring required

Response

Mandate record (schema agent-commerce-mandate.v1, approval_status draft or approved sandbox envelope)

Changes

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