Mandate requests

Answer, prepare or sign a mandate request

POST
/api/mandate-requests/{requestId}
  • answer: answers the agent's open questions; the draft is re-read from the new text.
  • prepare: the exact mandate this device's key must sign.
  • sign: stores the signed mandate; it must match the request byte for byte (same words, limits and agent).

Path Parameters

requestId*string

Mandate request id.

Formatuuid

Request Body

application/json

The shopper's answer, a request to prepare the mandate, or the signed mandate.

One of answer, prepare or sign, chosen by action.

Answer the agent's open questions.

action*"answer"

Always answer.

Value in

  • "answer"
answers*

Each open question (exactly as asked) mapped to the shopper's answer.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/mandate-requests/7d1f0c2a-3b4e-4f5a-9c6d-8e7f1a2b3c4d" \  -H "Content-Type: application/json" \  -d '{    "action": "answer",    "answers": {      "What size?": "M"    }  }'
{  "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": []    },    "agent": {      "name": "Claude",      "verified": false    }  },  "signingMessage": "undo-intent-mandate-v1:7bf66d54681f2b73e2f05ee0d49b5a68776908620751daaf0102b9f0b17fcac6"}