Mandate requests
Answer, prepare or sign a mandate request
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.
Format
uuidRequest 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"}