agent.mandate_create
Create or update an AP2-compatible spend mandate for a REGISTERED or VERIFIED DPX agent. Sets per-agent settlement constraints: max notional per settlement, daily cap, optional counterparty whitelist (LEIs or wallets), allowed currency pairs, ESG floor, and expiry. ANONYMOUS agents cannot hold mandates — register with ownerEntity + ownerEmail first. REGISTERED agents have mandate caps clamped to their tier limit ($25K). VERIFIED agents (GLEIF LEI confirmed) set their own caps with no platform ceiling. Mandate is AP2-formatted for interoperability with Google Agent Payments Protocol.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | Yes | Agent ID from agent.kya_register. | |
| esgFloor | No | Min counterparty ESG score (0 = no floor). | |
| issuedBy | No | Organization issuing this mandate. | |
| expiresAt | No | Unix timestamp for mandate expiry. | |
| dailyCapUsd | Yes | Max USD per calendar day (UTC). | |
| currencyPairs | No | Allowed pairs e.g. ["USD|EUR"]. Empty = any pair. | |
| maxNotionalUsd | Yes | Max USD per single settlement. | |
| counterpartyWhitelist | No | LEIs or wallet addresses. Empty = any counterparty. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | No | ||
| mandate | No | Full mandate object. | |
| mandateId | No | Unique mandate ID (mnd_...). | |
| ap2Compatible | No | ||
| effectiveCaps | No | Actual caps after tier clamping. |