Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.
Private preview: this is rolling out and may not be available on your account yet.
Coming soon: payments arrive in a fast-follow release.
A Stamped Mandate is an authorisation you sign for what an agent may do for you. It belongs to your account, not to the agent that asked for it. This is your first one, and it’s a spending mandate: what your agent may spend on, how much, and until when. It’s one kind among several — see what a mandate can authorise. Your agent asks. You decide.Your agent can never approve its own mandate. It can propose one and check what you decided. Only you can approve it, with your passkey, on a Sumvin page in your own browser, away from the conversation.
Before you start
You’re verified. A request from an account that isn’t verified yet is refused, and your agent tells you which step is missing.
To approve from your agent: you’ve created your signing key, the passkey you approve with. You do this in your browser at the end of verification. The terminal uses its own key instead; see the terminal tab below.
Approve
In your agent (MCP, recommended)
In the terminal (CLI, for developers)
1
Ask for a limit
Tell your agent what you want it to be able to do, and how much it may spend. It proposes a mandate with mandate_request and tells you, in your own money’s terms, the most it would ever authorise.Nothing is granted yet. Asking twice for the same thing doesn’t create two requests; it re-opens the one you already have.
2
Open the review
In chat apps that support it, a Spending authority card appears in the conversation. It shows the limit (Up to), what it Spends on, when the request Lapses if you don’t answer, and, once signed, how long the mandate Lasts until. Choose Review and sign; your browser opens.A request to read your linked accounts or prove your balance shows Reads, Proves or Reads and proves in place of Spends on, and has no limit.Everywhere else, your agent gives you a link to open instead. The link is issued once. If it’s lost, ask your agent to request the mandate again.
3
Set up your signing key (only if you skipped it)
You normally create your signing key at the end of verification. If you didn’t, the page says this account can’t approve requests yet and offers Set up your signing key. Follow it and create a passkey when your browser asks. Then ask your agent to request the mandate again.You do this once. Later reviews go straight to the request.
4
Read what you're signing
The page is headed An agent is asking for spending authority and shows who you’re approving as. Under Your signature binds it lists the statement, what the mandate spends on, and how long it lasts. What you see here is exactly what you sign.
5
Grant or decline
Choose Grant this authority and confirm with your passkey, or choose Decline. Soon after you create your signing key, the page may say your account is finishing setup; it carries on by itself. Declining authorises nothing and needs no signature. The page confirms Authority granted or Request declined, and tells you to return to your agent.
6
Back in the conversation
The card updates to show your decision. Your agent learns the outcome by checking with mandate_status; nothing is pushed to it, so it may need a moment before it checks.
In the terminal, you approve a Stamped Mandate when an errand is waiting for your signature, before it searches.
1
Set up a signing key (first time only)
sumvin keys generatesumvin keys add-to-safe
keys generate creates a signing key on this machine. keys add-to-safe registers it to your account and waits until the registration is confirmed. Your key stays on your machine.
2
Review the mandate
sumvin errand approve <errand-id>
The CLI shows the statement, the spend limit on its own line, and the expiry, then asks you to confirm:
Errand: <errand-id>You are signing this errand's bounds, not a chosen product. Nothing has beensearched for yet; a match found within these bounds is bought without asking again.Authorise a purchase: “Order two boxes of A4 paper”, spending up to 200.00 USD. The purchase is paid with your Visa card ending 4242. It proceeds only while all of the following hold:- the price is at most 180 USD- availability is one of: in_stockA match found within these bounds is bought without asking again. This authorisation lapses on 12 Aug 2026, 07:30 UTC.Ceiling: Up to USD 200.00Expires: 2026-08-12T07:30:00.000Z (6:59:12)Sign this errand's bounds? A match within them will be bought without asking you again.
You are signing bounds, not a chosen product. Read the ceiling as carefully as the statement: it is shown on its own line, and it is what your signature binds.
3
Confirm or decline
Answer y to sign. The errand then searches within your bounds. Anything else sends nothing. To decline instead:
sumvin errand reject <errand-id>
Declining cancels the errand. Nothing is signed, nothing is searched, and nothing is spent.
What you’ll see
Status
What it means
Waiting on you
You haven’t answered yet. Nothing is authorised.
Granted
You signed. Your agent can now spend within this limit.
Declined
Nothing was authorised.
Lapsed
The request expired unanswered. Nothing was authorised. Ask your agent to request it again.
Replaced
A newer request replaced this one. Use the latest card.
Your agent sees these as proposed, stamped, declined and expired. If a request ended some other way than you answering it, for example it was withdrawn, your agent receives a reason it can read back to you.
Two ways to approve
For a purchase, the order is always the same: you ask, you sign, then Sumvin searches, checks the merchant, watches for your conditions, and settles. A Stamped Mandate can cover that in one of two ways:
Sign each errand. You sign each errand’s bounds before it searches. A match found within them is bought without asking you again. This is the default.
Pre-authorise repeat errands. One signature, with limits, covers several matching errands, so each one doesn’t wait for a new signature. See Repeat errands.
What can go wrong
The card says the review page couldn't be opened
Ask your agent for the review link and open it yourself.
The page says your account setup isn't finished
You’ll see Your account setup isn’t finished. Finish verification, then ask your agent to request the mandate again. You can still decline the request so your agent isn’t left waiting.
The page says your signing key isn't set up yet
You haven’t created your signing key. Choose Set up your signing key, create your passkey, then ask your agent to request the mandate again. You can still decline the request so your agent isn’t left waiting.
The page says 'Signing key unavailable'
Your signing key couldn’t be unlocked on this device. Nothing was authorised. Try again with the passkey you created, or ask your agent to try again if this keeps happening.
The page says 'Different account' or 'Different signing key'
You’re signed in as someone other than the account your agent named. Sign in with the right account, then try again.
The link expired or was already decided
Link expired means the request lapsed; ask your agent to request it again. Already decided means there is nothing left to do.
In the terminal: 'This errand's approval mandate has expired'
You can’t approve an expired mandate. Run sumvin errand reject <errand-id> to close the errand, then start a new one.
In the terminal: the signature isn't recognised
Run sumvin errand approve again; each run fetches the current terms. If it fails again, check your key with sumvin keys show.
Try asking your agent: “Set up a spending limit of $50 for groceries this week.”
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sumvin","description":"Identity for every agent. Give your agent a verified identity, set the limits it acts within, and let it run errands for you.","colors":{"primary":"#1A6B3C","light":"#8BC540","dark":"#1A6B3C"},"logo":{"light":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b","dark":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/dark.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=6cdf55e6a87e956d6d7fca6f5b65caa3","href":"/"},"favicon":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/favicon.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=414a08a95872d9ecf8eaf56bf5176cc9","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#F5F2EE","dark":"#0E1116"}},"navbar":{"primary":{"type":"button","label":"Connect your agent","href":"/get-started/connect"}},"seo":{"metatags":{"og:site_name":"Sumvin Docs","og:type":"website","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"Playfair Display","weight":500},"body":{"family":"DM Sans","weight":400}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"latex":true},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp","add-mcp"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sumvin","hasAudioNarration":false,"actualSubdomain":"sumvin","customDomains":["docs.sumvin.com"],"gitSource":{"type":"github","owner":"sibylline-advisory","repo":"sumvin-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6acf382b2e3d8da06f635a9a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Concepts","count":16},{"language":"default","tag":"SDK","count":14},{"language":"default","tag":"Reference","count":13},{"language":"default","tag":"Get started","count":12},{"language":"default","tag":"Stamped Mandates","count":7},{"language":"default","tag":"CLI","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"The nouns","count":5},{"language":"default","tag":"Everyday","count":5},{"language":"default","tag":"Check a mandate","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--gray-50: 245 242 238;--gray-100: 238 235 230;--gray-200: 225 221 214;--gray-300: 204 199 192;--gray-400: 158 154 148;--gray-500: 112 111 110;--gray-600: 80 82 87;--gray-700: 58 62 70;--gray-800: 36 40 48;--gray-900: 23 27 34;--gray-950: 14 17 22;--sv-ground: #f5f2ee;--sv-ink: #0a0a0a;--sv-muted: rgb(10 10 10 / 0.65);--sv-surface: #f0ede8;--sv-border: rgb(10 10 10 / 0.08);--sv-lime: #8bc540;--sv-forest: #1a6b3c;--sv-teal: #0d2e2b;--sv-danger: #e5412d;--sv-mono: \"JetBrains Mono\", ui-monospace, \"SFMono-Regular\", monospace;--sv-radius: 10px;--sv-radius-xl: 14px;--sv-radius-pill: 9999px;--sv-ease: cubic-bezier(0.16, 1, 0.3, 1)}.dark{--sv-ground: #0e1116;--sv-ink: #f5f2ee;--sv-muted: rgb(245 242 238 / 0.65);--sv-surface: #171b22;--sv-border: rgb(245 242 238 / 0.1);--sv-danger: #f97b73}code,pre,code-block,eyebrow{font-family:var(--sv-mono)}eyebrow{text-transform:uppercase;letter-spacing:0.08em;font-size:0.72rem;font-weight:500}#page-title,#content-area h1,#content-area h2,#content-area h3{font-weight:500;letter-spacing:-0.02em}#content-area h3{letter-spacing:-0.01em}mdx-content table,code{font-variant-numeric:tabular-nums}#navbar{background:color-mix(in oklch, var(--sv-ground) 82%, transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-bottom:1px solid var(--sv-border)}.nav-tabs-item[data-active]{color:var(--sv-ink)}html,body{background-color:var(--sv-ground)}#sidebar-content li[data-active]{font-weight:600}toc-item[data-active-deepest]{font-weight:600}#topbar-cta-button a>span:first-child{background:var(--sv-lime);border-radius:var(--sv-radius-pill);transition:background-color 0.3s var(--sv-ease)}#topbar-cta-button a,#topbar-cta-button a *{color:#0a0a0a}#topbar-cta-button a:hover>span:first-child{background:#0a0a0a;opacity:1}#topbar-cta-button a:hover,#topbar-cta-button a:hover *{color:var(--sv-lime)}card{border-radius:var(--sv-radius-xl);border-color:var(--sv-border);box-shadow:inset 0 1px 0 0 rgb(255 255 255 / 0.04);transition:border-color 0.4s var(--sv-ease)}card:hover{border-color:color-mix(in oklch, var(--sv-lime) 55%, transparent)}callout,[data-callout-type]{border-radius:var(--sv-radius)}[data-callout-type=\"note\"]{background:var(--sv-surface);border-color:var(--sv-border);border-left:3px solid var(--sv-forest)}[data-callout-type=\"note\"],[data-callout-type=\"note\"] *{color:var(--sv-ink)}[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-forest)}.dark [data-callout-type=\"note\"]{border-left-color:var(--sv-lime)}.dark [data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-lime)}code-block,code-group{border-radius:var(--sv-radius)}a:focus-visible,button:focus-visible,card:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--sv-lime);outline-offset:2px}.sv-page{color:var(--sv-ink)}.sv-hero{background:var(--sv-teal);color:#f5f2ee}.sv-wrap{max-width:72rem;margin:0 auto;padding-left:clamp(1.25rem, 4vw, 3rem);padding-right:clamp(1.25rem, 4vw, 3rem)}.sv-eyebrow{font-family:var(--sv-mono);font-weight:500;text-transform:uppercase;letter-spacing:0.14em;font-size:0.75rem}.sv-hero .sv-eyebrow{color:var(--sv-lime)}.sv-display{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-weight:500;font-size:clamp(2.75rem, 1.6rem + 4.6vw, 5.25rem);line-height:1.04;letter-spacing:-0.03em;max-width:14ch;margin:0}.sv-lede{font-size:clamp(1.05rem, 0.95rem + 0.4vw, 1.25rem);line-height:1.55;max-width:38rem;color:rgb(245 242 238 / 0.78)}.sv-muted{color:var(--sv-muted)}.sv-doors{display:grid;grid-template-columns:repeat(auto-fit, minmax(17rem, 1fr));gap:1rem;max-width:46rem}.sv-door{display:flex;flex-direction:column;gap:0.35rem;padding:1.25rem 1.4rem;border-radius:var(--sv-radius-xl);border:1px solid rgb(245 242 238 / 0.18);color:#f5f2ee;text-decoration:none;transition:background-color 0.3s var(--sv-ease), color 0.3s var(--sv-ease),\n border-color 0.3s var(--sv-ease)}.sv-door:hover{border-color:rgb(245 242 238 / 0.45)}.sv-door--primary{background:var(--sv-lime);border-color:var(--sv-lime);color:#0a0a0a}.sv-door--primary:hover{background:#0a0a0a;border-color:#0a0a0a;color:var(--sv-lime)}.sv-door-title{font-weight:600;font-size:1.05rem}.sv-door-meta{font-family:var(--sv-mono);font-size:0.78rem;opacity:0.8}.sv-journey{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fit, minmax(10.5rem, 1fr));border-top:1px solid var(--sv-border)}.sv-station{padding:1.25rem 1.25rem 1.5rem 0}.sv-station a{display:flex;flex-direction:column;gap:0.4rem;color:var(--sv-ink);text-decoration:none}.sv-station-num{font-family:var(--sv-mono);font-size:0.75rem;letter-spacing:0.08em;color:var(--sv-muted)}.sv-station-name{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.5rem;font-weight:500;line-height:1.2}.sv-station a:hover .sv-station-name{text-decoration:underline;text-decoration-color:var(--sv-lime);text-decoration-thickness:2px;text-underline-offset:6px}.sv-station-copy{font-size:0.925rem;line-height:1.5;color:var(--sv-muted);max-width:22ch}.sv-rule{border-top:1px solid var(--sv-border)}.sv-partners{display:flex;flex-wrap:wrap;gap:0.75rem 2.5rem;align-items:baseline}.sv-partner{color:var(--sv-ink);text-decoration:none;font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.35rem;font-weight:500}.sv-partner:hover{text-decoration:underline;text-decoration-color:var(--sv-lime);text-underline-offset:5px}.sv-partner-role{display:block;font-family:var(--sv-mono);font-size:0.72rem;letter-spacing:0.06em;text-transform:uppercase;color:var(--sv-muted)}.sv-agent-line code{font-size:0.9em}.sv-agent-line a{color:var(--sv-ink);text-decoration-color:var(--sv-lime);text-underline-offset:4px}@keyframes sv-in{from{opacity:0;transform:translateY(8px) scale(0.98)}to{opacity:1;transform:none}}.sv-enter{animation:sv-in 0.5s var(--sv-ease) both}.sv-enter-2{animation:sv-in 0.5s var(--sv-ease) 90ms both}.sv-enter-3{animation:sv-in 0.5s var(--sv-ease) 180ms both}@media (prefers-reduced-motion: reduce){.sv-enter,.sv-enter-2,.sv-enter-3{animation:none}card,.sv-door{transition:none}}"}]}
{"page":{"pagePath":"get-started/first/stamped-mandate","slug":"/get-started/first/stamped-mandate","pageMetadata":{"title":"Approve your first Stamped Mandate","sidebarTitle":"Stamped Mandate","description":"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.","icon":"stamp","href":"/get-started/first/stamped-mandate"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const waitlists={earlyAccess:`https://sumvin.com/?interest=early_access\u0026utm_source=docs\u0026utm_medium=banner\u0026utm_campaign=early_access#waitlist`,payments:`https://sumvin.com/?interest=payments\u0026utm_source=docs\u0026utm_medium=banner\u0026utm_campaign=payments#waitlist`,openBanking:`https://sumvin.com/?interest=open_banking\u0026utm_source=docs\u0026utm_medium=banner\u0026utm_campaign=open_banking#waitlist`,developers:`https://sumvin.com/developers?interest=cli,agent_plugin\u0026utm_source=docs\u0026utm_medium=banner\u0026utm_campaign=developers#access`,verifiers:`https://sumvin.com/developers?interest=verifiers\u0026utm_source=docs\u0026utm_medium=banner\u0026utm_campaign=verifiers#access`};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Note,Step,Steps,Tab,Table,Tabs,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Private preview:`}),` this is rolling out and may not be available on your account yet.`,waitlists.earlyAccess?_jsxs(_Fragment,{children:[` `,_jsx(_components.a,{href:waitlists.earlyAccess,children:`Request early access →`})]}):null]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Coming soon:`}),` payments arrive in a fast-follow release.`,waitlists.payments?_jsxs(_Fragment,{children:[` `,_jsx(_components.a,{href:waitlists.payments,children:`Join the waitlist →`})]}):` A waitlist opens shortly.`]})}),`\n`,_jsxs(_components.p,{children:[`A Stamped Mandate is an authorisation you sign for what an agent may do for you. It belongs to your account, not to the agent that asked for it. This is your first one, and it’s a spending mandate: what your agent may spend on, how much, and until when. It’s one kind among several — see `,_jsx(_components.a,{href:`/concepts/mandates/use-cases`,children:`what a mandate can authorise`}),`. Your agent asks. You decide.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your agent can never approve its own mandate.`}),` It can propose one and check what you decided. Only you can approve it, with your passkey, on a Sumvin page in your own browser, away from the conversation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`You’re `,_jsx(_components.a,{href:`/get-started/first/verify`,children:`verified`}),`. A request from an account that isn’t verified yet is refused, and your agent tells you which step is missing.`]}),`\n`,_jsxs(_components.li,{children:[`To approve from your agent: you’ve created your signing key, the passkey you approve with. You do this in your browser at the end of `,_jsx(_components.a,{href:`/get-started/first/verify`,children:`verification`}),`. The terminal uses its own key instead; see the terminal tab below.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`approve`,children:`Approve`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`In your agent (MCP, recommended)`,id:`in-your-agent-mcp%2C-recommended`,children:_jsxs(Steps,{children:[_jsxs(Step,{title:`Ask for a limit`,children:[_jsxs(_components.p,{children:[`Tell your agent what you want it to be able to do, and how much it may spend. It proposes a mandate with `,_jsx(_components.code,{children:`mandate_request`}),` and tells you, in your own money’s terms, the most it would ever authorise.`]}),_jsx(_components.p,{children:`Nothing is granted yet. Asking twice for the same thing doesn’t create two requests; it re-opens the one you already have.`})]}),_jsxs(Step,{title:`Open the review`,children:[_jsxs(_components.p,{children:[`In chat apps that support it, a `,_jsx(_components.strong,{children:`Spending authority`}),` card appears in the conversation. It shows the limit (`,_jsx(_components.strong,{children:`Up to`}),`), what it `,_jsx(_components.strong,{children:`Spends on`}),`, when the request `,_jsx(_components.strong,{children:`Lapses`}),` if you don’t answer, and, once signed, how long the mandate `,_jsx(_components.strong,{children:`Lasts until`}),`. Choose `,_jsx(_components.strong,{children:`Review and sign`}),`; your browser opens.`]}),_jsxs(_components.p,{children:[`A request to read your linked accounts or prove your balance shows `,_jsx(_components.strong,{children:`Reads`}),`, `,_jsx(_components.strong,{children:`Proves`}),` or `,_jsx(_components.strong,{children:`Reads and proves`}),` in place of `,_jsx(_components.strong,{children:`Spends on`}),`, and has no limit.`]}),_jsx(_components.p,{children:`Everywhere else, your agent gives you a link to open instead. The link is issued once. If it’s lost, ask your agent to request the mandate again.`})]}),_jsxs(Step,{title:`Set up your signing key (only if you skipped it)`,children:[_jsxs(_components.p,{children:[`You normally create your signing key at the end of verification. If you didn’t, the page says this account can’t approve requests yet and offers `,_jsx(_components.strong,{children:`Set up your signing key`}),`. Follow it and create a passkey when your browser asks. Then ask your agent to request the mandate again.`]}),_jsx(_components.p,{children:`You do this once. Later reviews go straight to the request.`})]}),_jsx(Step,{title:`Read what you're signing`,children:_jsxs(_components.p,{children:[`The page is headed `,_jsx(_components.strong,{children:`An agent is asking for spending authority`}),` and shows who you’re approving as. Under `,_jsx(_components.strong,{children:`Your signature binds`}),` it lists the statement, what the mandate spends on, and how long it lasts. What you see here is exactly what you sign.`]})}),_jsx(Step,{title:`Grant or decline`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Grant this authority`}),` and confirm with your passkey, or choose `,_jsx(_components.strong,{children:`Decline`}),`. Soon after you create your signing key, the page may say your account is finishing setup; it carries on by itself. Declining authorises nothing and needs no signature. The page confirms `,_jsx(_components.strong,{children:`Authority granted`}),` or `,_jsx(_components.strong,{children:`Request declined`}),`, and tells you to return to your agent.`]})}),_jsx(Step,{title:`Back in the conversation`,children:_jsxs(_components.p,{children:[`The card updates to show your decision. Your agent learns the outcome by checking with `,_jsx(_components.code,{children:`mandate_status`}),`; nothing is pushed to it, so it may need a moment before it checks.`]})})]})}),_jsxs(Tab,{title:`In the terminal (CLI, for developers)`,id:`in-the-terminal-cli%2C-for-developers`,children:[_jsxs(_components.p,{children:[`In the terminal, you approve a Stamped Mandate when an `,_jsx(_components.a,{href:`/get-started/first/errand`,children:`errand`}),` is waiting for your signature, before it searches.`]}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Set up a signing key (first time only)`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes vitesse-light vitesse-dark`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#121212`,color:`#393a34`,\"--shiki-dark\":`#dbd7caee`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#59873A`,\"--shiki-dark\":`#80A665`},children:`sumvin`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` keys`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` generate`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#59873A`,\"--shiki-dark\":`#80A665`},children:`sumvin`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` keys`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` add-to-safe`})]}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`keys generate`}),` creates a signing key on this machine. `,_jsx(_components.code,{children:`keys add-to-safe`}),` registers it to your account and waits until the registration is confirmed. Your key stays on your machine.`]})]}),_jsxs(Step,{title:`Review the mandate`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes vitesse-light vitesse-dark`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#121212`,color:`#393a34`,\"--shiki-dark\":`#dbd7caee`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#59873A`,\"--shiki-dark\":`#80A665`},children:`sumvin`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` errand`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` approve`}),_jsx(_components.span,{style:{color:`#AB5959`,\"--shiki-dark\":`#CB7676`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:`errand-i`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:`d`}),_jsx(_components.span,{style:{color:`#AB5959`,\"--shiki-dark\":`#CB7676`},children:`>`})]}),`\n`]})})}),_jsx(_components.p,{children:`The CLI shows the statement, the spend limit on its own line, and the expiry, then asks you to confirm:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes vitesse-light vitesse-dark`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#121212`,color:`#393a34`,\"--shiki-dark\":`#dbd7caee`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Errand: \u003cerrand-id>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You are signing this errand's bounds, not a chosen product. Nothing has been`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`searched for yet; a match found within these bounds is bought without asking again.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorise a purchase: “Order two boxes of A4 paper”, spending up to 200.00 USD. The purchase is paid with your Visa card ending 4242. It proceeds only while all of the following hold:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- the price is at most 180 USD`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- availability is one of: in_stock`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`A match found within these bounds is bought without asking again. This authorisation lapses on 12 Aug 2026, 07:30 UTC.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Ceiling: Up to USD 200.00`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Expires: 2026-08-12T07:30:00.000Z (6:59:12)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Sign this errand's bounds? A match within them will be bought without asking you again.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`You are signing bounds, not a chosen product. Read the ceiling as carefully as the statement: it is shown on its own line, and it is what your signature binds.`})]}),_jsxs(Step,{title:`Confirm or decline`,children:[_jsxs(_components.p,{children:[`Answer `,_jsx(_components.code,{children:`y`}),` to sign. The errand then searches within your bounds. Anything else sends nothing. To decline instead:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes vitesse-light vitesse-dark`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#121212`,color:`#393a34`,\"--shiki-dark\":`#dbd7caee`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#59873A`,\"--shiki-dark\":`#80A665`},children:`sumvin`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` errand`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:` reject`}),_jsx(_components.span,{style:{color:`#AB5959`,\"--shiki-dark\":`#CB7676`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:`errand-i`}),_jsx(_components.span,{style:{color:`#B56959`,\"--shiki-dark\":`#C98A7D`},children:`d`}),_jsx(_components.span,{style:{color:`#AB5959`,\"--shiki-dark\":`#CB7676`},children:`>`})]}),`\n`]})})}),_jsx(_components.p,{children:`Declining cancels the errand. Nothing is signed, nothing is searched, and nothing is spent.`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you’ll-see`,children:`What you’ll see`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Waiting on you`}),_jsx(_components.td,{children:`You haven’t answered yet. Nothing is authorised.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Granted`}),_jsx(_components.td,{children:`You signed. Your agent can now spend within this limit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Declined`}),_jsx(_components.td,{children:`Nothing was authorised.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Lapsed`}),_jsx(_components.td,{children:`The request expired unanswered. Nothing was authorised. Ask your agent to request it again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Replaced`}),_jsx(_components.td,{children:`A newer request replaced this one. Use the latest card.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Your agent sees these as `,_jsx(_components.code,{children:`proposed`}),`, `,_jsx(_components.code,{children:`stamped`}),`, `,_jsx(_components.code,{children:`declined`}),` and `,_jsx(_components.code,{children:`expired`}),`. If a request ended some other way than you answering it, for example it was withdrawn, your agent receives a reason it can read back to you.`]}),`\n`,_jsx(Heading,{level:`2`,id:`two-ways-to-approve`,children:`Two ways to approve`}),`\n`,_jsx(_components.p,{children:`For a purchase, the order is always the same: you ask, you sign, then Sumvin searches, checks the merchant, watches for your conditions, and settles. A Stamped Mandate can cover that in one of two ways:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sign each errand.`}),` You sign each errand’s bounds before it searches. A match found within them is bought without asking you again. This is the default.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pre-authorise repeat errands.`}),` One signature, with limits, covers several matching errands, so each one doesn’t wait for a new signature. See `,_jsx(_components.a,{href:`/guides/repeat-errands`,children:`Repeat errands`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-can-go-wrong`,children:`What can go wrong`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The card says the review page couldn't be opened`,id:`the-card-says-the-review-page-couldnt-be-opened`,children:_jsx(_components.p,{children:`Ask your agent for the review link and open it yourself.`})}),_jsx(Accordion,{title:`The page says your account setup isn't finished`,id:`the-page-says-your-account-setup-isnt-finished`,children:_jsxs(_components.p,{children:[`You’ll see `,_jsx(_components.strong,{children:`Your account setup isn’t finished`}),`. Finish `,_jsx(_components.a,{href:`/get-started/first/verify`,children:`verification`}),`, then ask your agent to request the mandate again. You can still decline the request so your agent isn’t left waiting.`]})}),_jsx(Accordion,{title:`The page says your signing key isn't set up yet`,id:`the-page-says-your-signing-key-isnt-set-up-yet`,children:_jsxs(_components.p,{children:[`You haven’t created your signing key. Choose `,_jsx(_components.strong,{children:`Set up your signing key`}),`, create your passkey, then ask your agent to request the mandate again. You can still decline the request so your agent isn’t left waiting.`]})}),_jsx(Accordion,{title:`The page says 'Signing key unavailable'`,id:`the-page-says-signing-key-unavailable`,children:_jsx(_components.p,{children:`Your signing key couldn’t be unlocked on this device. Nothing was authorised. Try again with the passkey you created, or ask your agent to try again if this keeps happening.`})}),_jsx(Accordion,{title:`The page says 'Different account' or 'Different signing key'`,id:`the-page-says-different-account-or-different-signing-key`,children:_jsx(_components.p,{children:`You’re signed in as someone other than the account your agent named. Sign in with the right account, then try again.`})}),_jsx(Accordion,{title:`The link expired or was already decided`,id:`the-link-expired-or-was-already-decided`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Link expired`}),` means the request lapsed; ask your agent to request it again. `,_jsx(_components.strong,{children:`Already decided`}),` means there is nothing left to do.`]})}),_jsx(Accordion,{title:`In the terminal: 'This errand's approval mandate has expired'`,id:`in-the-terminal-this-errands-approval-mandate-has-expired`,children:_jsxs(_components.p,{children:[`You can’t approve an expired mandate. Run `,_jsx(_components.code,{children:`sumvin errand reject \u003cerrand-id>`}),` to close the errand, then start a new one.`]})}),_jsx(Accordion,{title:`In the terminal: the signature isn't recognised`,id:`in-the-terminal-the-signature-isnt-recognised`,children:_jsxs(_components.p,{children:[`Run `,_jsx(_components.code,{children:`sumvin errand approve`}),` again; each run fetches the current terms. If it fails again, check your key with `,_jsx(_components.code,{children:`sumvin keys show`}),`.`]})})]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Set up a spending limit of $50 for groceries this week.”`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{waitlists,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"config":{},"pageMetadata":{"title":"Approve your first Stamped Mandate","sidebarTitle":"Stamped Mandate","description":"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.","icon":"stamp","href":"/get-started/first/stamped-mandate"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[144,779,"undefined;function _"],[1816,1960,""],[2116,2275,""]]},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Approve","slug":"approve","depth":2,"children":[]},{"title":"What you’ll see","slug":"what-you’ll-see","depth":2,"children":[]},{"title":"Two ways to approve","slug":"two-ways-to-approve","depth":2,"children":[]},{"title":"What can go wrong","slug":"what-can-go-wrong","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sumvin","siteName":"Sumvin","title":"Approve your first Stamped Mandate - Sumvin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T10:33:30.071Z","originalFileLocation":"get-started/first/stamped-mandate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Approve your first Stamped Mandate - Sumvin\">\u003cmeta data-mint-head property=\"og:description\" content=\"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sumvin Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sumvin.com/get-started/first/stamped-mandate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=Your+first\u0026amp;title=Approve+your+first+Stamped+Mandate\u0026amp;description=Your+agent+proposes+a+spending+mandate+%E2%80%94+one+kind+of+Stamped+Mandate+%E2%80%94+you+review+it+on+your+own+page%2C+and+you+approve+exactly+what+you+see+with+your+passkey%3B+y\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=4086baf096c85e2d9abb6d74d845341c2fdf36dd77cb6202f3e9adf9d75e1b42\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Approve your first Stamped Mandate - Sumvin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=Your+first\u0026amp;title=Approve+your+first+Stamped+Mandate\u0026amp;description=Your+agent+proposes+a+spending+mandate+%E2%80%94+one+kind+of+Stamped+Mandate+%E2%80%94+you+review+it+on+your+own+page%2C+and+you+approve+exactly+what+you+see+with+your+passkey%3B+y\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=4086baf096c85e2d9abb6d74d845341c2fdf36dd77cb6202f3e9adf9d75e1b42\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A6B3C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sumvin.com/get-started/first/stamped-mandate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/get-started/first/stamped-mandate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sumvin.com/#organization\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sumvin.com#website\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sumvin.com/get-started/first/stamped-mandate#webpage\",\"url\":\"https://docs.sumvin.com/get-started/first/stamped-mandate\",\"name\":\"Approve your first Stamped Mandate\",\"description\":\"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\",\"dateModified\":\"2026-09-30T10:33:30.071Z\",\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sumvin.com/get-started/first/stamped-mandate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sumvin.com/get-started/first/stamped-mandate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Your first\",\"item\":\"https://docs.sumvin.com/get-started/first/verify\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Approve your first Stamped Mandate\",\"item\":\"https://docs.sumvin.com/get-started/first/stamped-mandate\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sumvin.com/get-started/first/stamped-mandate#article\",\"headline\":\"Approve your first Stamped Mandate\",\"name\":\"Approve your first Stamped Mandate\",\"description\":\"Your agent proposes a spending mandate — one kind of Stamped Mandate — you review it on your own page, and you approve exactly what you see with your passkey; your agent can never approve its own mandate.\",\"url\":\"https://docs.sumvin.com/get-started/first/stamped-mandate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sumvin.com/get-started/first/stamped-mandate#webpage\"},\"dateModified\":\"2026-09-30T10:33:30.071Z\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sumvin\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sumvin\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/get-started/first/stamped-mandate.md","siteName":"Sumvin","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"tabs":[{"tab":"Get started","icon":"compass","groups":[{"group":"Start here","pages":[{"title":"Sumvin","sidebarTitle":"Home","icon":"house","mode":"custom","href":""},{"title":"What is Sumvin","icon":"fingerprint","href":"/get-started/what-is-sumvin"},{"title":"How it works","icon":"workflow","href":"/get-started/how-it-works"}]},{"group":"Connect your agent","pages":[{"title":"Connect your agent","icon":"plug","sidebarTitle":"Connect","href":"/get-started/connect"},{"title":"Your first conversation","icon":"message-circle","sidebarTitle":"First conversation","href":"/get-started/first-conversation"}]},{"group":"Use the CLI","pages":[{"title":"Install the CLI","icon":"download","href":"/get-started/cli/install"},{"title":"Sign in","icon":"log-in","href":"/get-started/cli/sign-in"},{"title":"Use the CLI with your agent","icon":"bot","href":"/get-started/cli/with-your-agent"}]},{"group":"Your first","pages":[{"title":"Verify your identity","sidebarTitle":"Verify","icon":"scan-face","href":"/get-started/first/verify"},{"title":"See your Sigil","sidebarTitle":"Your Sigil","description":"Your Sigil is your verified identity; once it is ready, every agent you connect carries proof that a real person stands behind it.","icon":"fingerprint","href":"/get-started/first/sigil"},{"title":"Approve your first Stamped Mandate","sidebarTitle":"Stamped Mandate","icon":"stamp","href":"/get-started/first/stamped-mandate"},{"title":"Run your first errand","sidebarTitle":"Errand","description":"Ask your agent to do one thing for you; you answer any question, sign the errand's bounds, and follow it as Sumvin searches, checks the merchant, watches and settles.","icon":"shopping-bag","href":"/get-started/first/errand"}]}]},{"tab":"Concepts","icon":"book-open","pages":[{"title":"Concepts","href":"/concepts/sigil"}]},{"tab":"Guides","icon":"map","pages":[{"title":"Guides","href":"/guides/approve-or-decline"}]},{"tab":"Reference","icon":"square-terminal","pages":[{"title":"Reference","href":"/reference/mcp/tools"}]},{"tab":"SDK","icon":"package","pages":[{"title":"SDK","href":"/sdk/overview"}]}]},"basePath":"","title":"Approve your first Stamped Mandate - Sumvin","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}