Mandates

Build the exact mandate to sign

POST
/api/mandates/prepare

Returns the mandate the shopper's device must sign and the exact signingMessage (undo-intent-mandate-v1:<sha256 of the canonical mandate JSON>). Stateless; nothing is stored.

Request Body

application/json

The draft, the shopper's words and the device key that will sign.

What's needed to build the exact mandate a device will sign.

request*string

The shopper's request in their own words, kept verbatim inside the mandate.

Length3 <= length <= 1000
draft*

The shopper's limits in structured form.

shopperKey*string

Base64 Ed25519 public key.

Length40 <= length <= 60
payWith?"saved_wallet"

How the agent may pay.

Value in

  • "saved_wallet"

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/mandates/prepare" \  -H "Content-Type: application/json" \  -d '{    "request": "A black hoodie in size M under $80",    "draft": {      "item": "black hoodie",      "category": "hoodie",      "quantity": 1,      "maxPrice": 80,      "currency": "USD",      "attributes": {        "color": "black",        "size": "M"      },      "mustAsk": []    },    "shopperKey": "aHBQ5B27O2BiDV0oWgOigpsXZKjOfhcYYMch5pZ5H0c="  }'
{  "mandate": {    "version": 1,    "id": "2f4069f0-2367-4f08-acc6-d9cf1cf6669a",    "createdAt": "2026-10-20T04:18:17.928Z",    "expiresAt": "2026-11-03T04:18:17.928Z",    "shopperKey": "aHBQ5B27O2BiDV0oWgOigpsXZKjOfhcYYMch5pZ5H0c=",    "request": "Buy me black men's running shoes, size 10, under $120",    "intent": {      "item": "running shoes",      "category": "running shoes",      "quantity": 1,      "maxPrice": 120,      "currency": "USD",      "attributes": {        "size": "10",        "color": "black"      },      "gender": "male",      "mustAsk": []    }  },  "signingMessage": "undo-intent-mandate-v1:7bf66d54681f2b73e2f05ee0d49b5a68776908620751daaf0102b9f0b17fcac6"}