{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
Agentic Payments
Create an x402 spend mandate (BETA)
Beta — early access.
Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller’s 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so “100000” is $0.10).
The budget belongs to the agent’s x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent’s live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate’s window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent.
A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reasonendorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}
Authorizations
x-api-key
string
header
required
Headers
x-idempotency-key
string<uuid>
required
Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.
A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a
successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or
whitespace) with the same key within that window returns the original response with
X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same
endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is
not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason
can be corrected and retried under the same key. Request bodies that are not JSON (for example file
uploads) are not compared.
Path Parameters
payment_agent_id
string
required
Body
application/json
asset
string
required
Asset symbol. Only USDC is supported in this release; any other value is refused with a 400, since such a mandate could never be used.
network
string
required
Network the mandate covers, e.g. base-sepolia. Only Base and Base Sepolia are supported.
max_per_call
string
required
Per-authorization ceiling, in atomic units.
max_per_window
string
Ceiling on total committed spend across ALL payees in one rolling window, in atomic units. Omit for unbounded (discouraged).
window_seconds
integer
Rolling aggregate window. Defaults to 24h.
max_calls_per_window
integer
Optional cap on authorizations per window. 0 is no cap.
valid_for_seconds
integer
Mandate lifetime from now. Defaults to 30 days.
payee_policy
object
What an x402 mandate may pay for, beyond its budget. Omit the whole object to leave the budget as the only control.
mode is required when the object is present, and the list must match it: address_allowlist needs addresses and reads no domains, domain_allowlist needs domains and reads no addresses, and any_screened enforces neither, so it carries no list. A policy that breaks those rules is refused with a 400 rather than stored as a restriction nothing applies.
any_screened accepts any payee that passes address screening. address_allowlist pins the payee address itself. domain_allowlist pins the RESOURCE host the caller names when it asks for a signature - the readable form, since an operator approves "any metered API under this vendor's domain" rather than a hex address. Note that it bounds the resource, not the payee: a seller who prices one resource can be paid for it whatever address it nominates.
Show child attributes
Response
Mandate created
id
string
required
agent_id
string
required
wallet_id
string
required
asset
string
required
network
string
required
max_per_call
string
required
window_seconds
integer
required
payee_policy
object
required
What an x402 mandate may pay for, beyond its budget. Omit the whole object to leave the budget as the only control.
mode is required when the object is present, and the list must match it: address_allowlist needs addresses and reads no domains, domain_allowlist needs domains and reads no addresses, and any_screened enforces neither, so it carries no list. A policy that breaks those rules is refused with a 400 rather than stored as a restriction nothing applies.
any_screened accepts any payee that passes address screening. address_allowlist pins the payee address itself. domain_allowlist pins the RESOURCE host the caller names when it asks for a signature - the readable form, since an operator approves "any metered API under this vendor's domain" rather than a hex address. Note that it bounds the resource, not the payee: a seller who prices one resource can be paid for it whatever address it nominates.
Show child attributes
valid_from
string<date-time>
required
valid_until
string<date-time>
required
max_per_window
string
max_calls_per_window
integer
revoked_at
string<date-time>
When the mandate was cancelled, or replaced by a newer mandate for the same asset and network. A revoked mandate authorizes nothing.
window_committed
string
Spend already committed on this mandate's budget in the window ending now, in atomic units: every authorization from the agent's x402 wallet in this asset and network over this mandate's window_seconds, whichever mandate issued it, counting outstanding holds as well as settled ones. It is the budget's figure, not this mandate's own: a replaced or cancelled mandate shows the same spend as the mandate in force, so never add it up across mandates.
window_calls
integer
Authorizations already issued in the current window, counted the same way as window_committed.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dakota","colors":{"primary":"#8e4410","light":"#a36336","dark":"#72360d"},"logo":{"light":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-black.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=c409f7b8cec2e984bd0c79735f637bfe","dark":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-white.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=9e77213d983822ac9d3e6cb211500b1f"},"favicon":"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/favicon.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=a998c62579c0a092af10b861d4c26197","api":{"openapi":"openapi.yaml","params":{"expanded":"closed"},"playground":{"display":"simple","proxy":false},"examples":{"languages":["curl","javascript","python","go"]}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://platform.dakota.xyz/signin","label":"Login"}],"primary":{"type":"button","label":"Get Started","href":"https://dakota.xyz/talk-to-sales"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"search":{"prompt":"Search or ask..."},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://support.dakota.xyz"},{"anchor":"Contact us","icon":"envelope","href":"https://dakota.xyz/talk-to-sales"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dakota-49818541","hasAudioNarration":false,"actualSubdomain":"dakota-49818541","customDomains":["docs.dakota.xyz"],"gitSource":{"type":"github","owner":"dakota-xyz","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"documentation","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b006440baa97067db115bcf","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":200},{"language":"default","tag":"Documentation","count":80},{"language":"default","tag":"Cards","count":42},{"language":"default","tag":"Agentic Payments","count":32},{"language":"default","tag":"Onboarding","count":26},{"language":"default","tag":"Authentication","count":13},{"language":"default","tag":"Signer Groups","count":13},{"language":"default","tag":"Customers","count":11},{"language":"default","tag":"Policies","count":10},{"language":"default","tag":"RD Marketing Fee","count":9}]},"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":false},"customCss":[{"filePath":"global.css","content":"[data-callout=\"note\"]{--callout-bg: #291f14 !important;--callout-border: #523e27 !important;--callout-icon: #9c8873 !important;background:#291f14!important;border-color:#523e27!important}[data-callout=\"note\"] svg{color:#9c8873!important}[data-callout=\"tip\"]{--callout-bg: #391b06 !important;--callout-border: #8e4410 !important;--callout-icon: #b9825b !important;background:#391b06!important;border-color:#8e4410!important}[data-callout=\"tip\"] svg{color:#b9825b!important}[data-callout=\"warning\"]{--callout-bg: #310a0c !important;--callout-border: #7b181d !important;--callout-icon: #ab5e62 !important;background:#310a0c!important;border-color:#7b181d!important}[data-callout=\"warning\"] svg{color:#ab5e62!important}[data-callout=\"info\"]{--callout-bg: #232222 !important;--callout-border: #464543 !important;--callout-icon: #929190 !important;background:#232222!important;border-color:#464543!important}[data-callout=\"info\"] svg{color:#929190!important}[data-callout=\"check\"]{--callout-bg: #283126 !important;--callout-border: #647a5e !important;--callout-icon: #a2af9e !important;background:#283126!important;border-color:#647a5e!important}[data-callout=\"check\"] svg{color:#a2af9e!important}[data-callout]{color:#FFFFFF!important}[data-callout] p,[data-callout] span,[data-callout] li{color:#cdcccb!important}[data-callout] a{color:#cea181!important}[data-callout] a:hover{color:#e4c0a6!important}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):not(.card):not([class*=\"card\"]){color:var(--tw-prose-links);text-decoration:none;font-weight:600;border-bottom:1px solid rgba(142, 68, 16, 0.4);word-wrap:break-word;position:relative;z-index:10}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):not(.card):not([class*=\"card\"]):hover{border-bottom-color:rgba(142, 68, 16, 1)}.prose a[href*=\"llms.txt\"] code,.prose a[href*=\"llms-full.txt\"] code{background-color:rgba(142, 68, 16, 0.05);padding:2px 4px;border-radius:4px;font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;font-size:0.9em}.prose a[href*=\"llms.txt\"]:hover code,.prose a[href*=\"llms-full.txt\"]:hover code{background-color:rgba(142, 68, 16, 0.08)}.link,.link>code{position:relative}.link{z-index:10}.flow-modal-overlay{z-index:2147483647!important;position:fixed!important}.flow-modal-overlay>*{position:relative;z-index:1}.method-nav-pill{display:none!important}#floating-assistant-container{display:none!important;position:fixed;left:0;right:0;bottom:0;padding:0 1rem 1rem;flex-direction:column;align-items:center;width:100%;z-index:20;pointer-events:none}#floating-assistant-wrapper{z-index:10;width:100%;max-width:24rem;transition:max-width 300ms ease-out, transform 300ms ease-out}#floating-assistant-wrapper:hover{transform:scale(1.05)}#floating-assistant-wrapper:focus-within{max-width:30rem;transform:scale(1)}#floating-assistant-form{display:flex;flex-direction:column;width:100%;border-radius:1rem;pointer-events:auto;background:rgba(255, 255, 255, 0.9);backdrop-filter:blur(24px);border:1px solid rgba(200, 200, 200, 0.3);box-shadow:0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);transition:border-color 300ms}.dark #floating-assistant-form{background:rgba(30, 30, 30, 0.9);border-color:rgba(255, 255, 255, 0.3)}#floating-assistant-form:focus-within{border-color:#8e4410}.dark #floating-assistant-form:focus-within{border-color:#a36336}#floating-assistant-input-wrapper{position:relative;display:flex;align-items:end}#floating-assistant-input{width:100%;background:transparent;border:0;color:#111827;outline:none;padding:0.625rem 2.5rem 0.625rem 0.875rem;font-size:0.875rem;resize:none;height:60px!important;font-family:inherit}.dark #floating-assistant-input{color:#f3f4f6}#floating-assistant-input::placeholder{color:#6b7280}.dark #floating-assistant-input::placeholder{color:#9ca3af}#floating-assistant-shortcut-hint{position:absolute;right:2.75rem;bottom:0.75rem;font-size:0.75rem;font-weight:500;color:#9ca3af;user-select:none;pointer-events:none;display:none}@media (min-width: 640px){#floating-assistant-shortcut-hint{display:inline}}#floating-assistant-input:focus+#floating-assistant-shortcut-hint{display:none}#floating-assistant-submit{display:flex;justify-content:center;align-items:center;border-radius:9999px;padding:0.25rem;width:1.5rem;height:1.5rem;position:absolute;right:0.625rem;bottom:0.5rem;background:rgba(142, 68, 16, 0.3);border:none;cursor:not-allowed;transition:all 200ms}#floating-assistant-submit.active{background:#8e4410;cursor:pointer}#floating-assistant-submit.active:hover{background:#723609}.dark #floating-assistant-submit{background:rgba(163, 99, 54, 0.3)}.dark #floating-assistant-submit.active{background:#a36336}.dark #floating-assistant-submit.active:hover{background:#8e4410}#floating-assistant-submit svg{width:0.875rem;height:0.875rem;color:white}@media (max-width: 640px){#floating-assistant-wrapper{max-width:100%}#floating-assistant-wrapper:hover{transform:scale(1)}}body.dakota-env-switcher-mounted #sidebar-content{padding-bottom:5.5rem!important}#dakota-env-switcher{font-family:inherit;color:#f3f4f6;z-index:30}#dakota-env-switcher[data-in-sidebar=\"true\"]{position:absolute;left:1rem;right:1.25rem;bottom:1rem}#dakota-env-switcher[data-in-sidebar=\"false\"]{position:fixed;left:1rem;bottom:1rem;width:15rem;max-width:calc(100vw - 2rem)}#dakota-env-switcher[data-collapsed=\"true\"]{width:auto;right:auto}#dakota-env-toggle{display:flex;align-items:center;gap:0.5rem;width:100%;padding:0.5rem 0.75rem;border-radius:0.625rem;background:rgba(20, 20, 20, 0.92);border:1px solid rgba(255, 255, 255, 0.08);color:#f3f4f6;font-size:0.8125rem;font-weight:500;cursor:pointer;backdrop-filter:blur(16px);box-shadow:0 8px 20px -8px rgba(0, 0, 0, 0.45);transition:border-color 150ms ease, background 150ms ease}.light #dakota-env-toggle,html:not(.dark) #dakota-env-toggle{background:rgba(255, 255, 255, 0.95);border-color:rgba(0, 0, 0, 0.08);color:#1f2937}#dakota-env-toggle:hover{border-color:rgba(255, 255, 255, 0.18)}.light #dakota-env-toggle:hover,html:not(.dark) #dakota-env-toggle:hover{border-color:rgba(0, 0, 0, 0.18)}#dakota-env-switcher[data-collapsed=\"true\"] #dakota-env-toggle .dakota-env-label,#dakota-env-switcher[data-collapsed=\"true\"] #dakota-env-toggle .dakota-env-caret{display:none}#dakota-env-switcher .dakota-env-dot{width:0.5rem;height:0.5rem;border-radius:9999px;background:#d98e3e;flex-shrink:0;box-shadow:0 0 0 3px rgba(217, 142, 62, 0.18)}#dakota-env-switcher .dakota-env-dot[data-env=\"production\"]{background:#c63d3d;box-shadow:0 0 0 3px rgba(198, 61, 61, 0.18)}#dakota-env-switcher[data-env=\"production\"] #dakota-env-toggle .dakota-env-dot{background:#c63d3d;box-shadow:0 0 0 3px rgba(198, 61, 61, 0.18)}#dakota-env-switcher .dakota-env-label{flex:1;text-align:left;white-space:nowrap}#dakota-env-switcher .dakota-env-caret{opacity:0.6;flex-shrink:0;transition:transform 150ms ease}#dakota-env-switcher[data-open=\"true\"] .dakota-env-caret{transform:rotate(180deg)}#dakota-env-menu{display:none;margin-bottom:0.5rem;padding:0.375rem;border-radius:0.625rem;background:rgba(20, 20, 20, 0.96);border:1px solid rgba(255, 255, 255, 0.08);box-shadow:0 12px 30px -10px rgba(0, 0, 0, 0.55);backdrop-filter:blur(16px);position:absolute;bottom:100%;left:0;right:0}.light #dakota-env-menu,html:not(.dark) #dakota-env-menu{background:rgba(255, 255, 255, 0.98);border-color:rgba(0, 0, 0, 0.08)}#dakota-env-switcher[data-open=\"true\"] #dakota-env-menu{display:block}.dakota-env-menu-header{font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;color:#9ca3af;padding:0.5rem 0.625rem 0.375rem}.light .dakota-env-menu-header,html:not(.dark) .dakota-env-menu-header{color:#6b7280}.dakota-env-option{display:flex;align-items:center;gap:0.625rem;width:100%;padding:0.5rem 0.625rem;background:transparent;border:none;border-radius:0.5rem;color:inherit;text-align:left;cursor:pointer;transition:background 120ms ease}.dakota-env-option:hover{background:rgba(255, 255, 255, 0.06)}.light .dakota-env-option:hover,html:not(.dark) .dakota-env-option:hover{background:rgba(0, 0, 0, 0.04)}.dakota-env-option-text{display:flex;flex-direction:column;flex:1;min-width:0}.dakota-env-option-title{font-size:0.8125rem;font-weight:500;line-height:1.1}.dakota-env-option-host{font-size:0.6875rem;color:#9ca3af;font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;margin-top:0.125rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.light .dakota-env-option-host,html:not(.dark) .dakota-env-option-host{color:#6b7280}.dakota-env-check{opacity:0;color:#8e4410;flex-shrink:0}.dark .dakota-env-check{color:#cea181}.dakota-env-option[aria-selected=\"true\"] .dakota-env-check{opacity:1}.dakota-env-footer{font-size:0.6875rem;color:#9ca3af;padding:0.5rem 0.625rem 0.375rem;border-top:1px solid rgba(255, 255, 255, 0.06);margin-top:0.25rem;line-height:1.35}.light .dakota-env-footer,html:not(.dark) .dakota-env-footer{color:#6b7280;border-top-color:rgba(0, 0, 0, 0.06)}@media (max-width: 768px){#dakota-env-switcher{left:0.75rem;bottom:0.75rem;width:12rem}}[class*=\"Card_card\"]{padding:0.75rem!important}[class*=\"Card_card\"] h3,[class*=\"Card_card\"] [class*=\"title\"]{font-size:0.875rem!important;line-height:1.25rem!important}[class*=\"Card_card\"] p,[class*=\"Card_card\"] [class*=\"description\"]{font-size:0.75rem!important;line-height:1rem!important;margin-top:0.25rem!important}"}]}
{"page":{"pagePath":"api-reference/agentic-payments/create-an-x402-spend-mandate-beta","slug":"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta","pageMetadata":{"title":"Create an x402 spend mandate (BETA)","description":"> **Beta** — early access.\n\nCreates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller's 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \"100000\" is $0.10).\n\nThe budget belongs to the agent's x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent's live mandate for the same asset and network: the old one is cancelled in the same step (its `revoked_at` is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate's window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent.\n\nA mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and `reason` `endorsement_required`, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402/mandates","href":"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n blockquote: \"blockquote\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.blockquote, {\n children: [\"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Beta\"\n }), \" — early access.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller’s 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so “100000” is $0.10).\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The budget belongs to the agent’s x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent’s live mandate for the same asset and network: the old one is cancelled in the same step (its \", _jsx(_components.code, {\n children: \"revoked_at\"\n }), \" is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate’s window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and \", _jsx(_components.code, {\n children: \"reason\"\n }), \" \", _jsx(_components.code, {\n children: \"endorsement_required\"\n }), \", nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an x402 spend mandate (BETA)","description":"> **Beta** — early access.\n\nCreates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller's 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \"100000\" is $0.10).\n\nThe budget belongs to the agent's x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent's live mandate for the same asset and network: the old one is cancelled in the same step (its `revoked_at` is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate's window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent.\n\nA mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and `reason` `endorsement_required`, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402/mandates","href":"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dakota-49818541/166e91537ad3bb02/public/floating-assistant.js","/_mintlify/custom/dakota-49818541/98e4ee9d2a52c1e3/public/env-switcher.js"],"openApiReferenceData":{"operation":{"tags":["Agentic Payments"],"summary":"Create an x402 spend mandate (BETA)","description":"> **Beta** — early access.\n\nCreates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller's 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \"100000\" is $0.10).\n\nThe budget belongs to the agent's x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent's live mandate for the same asset and network: the old one is cancelled in the same step (its `revoked_at` is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate's window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent.\n\nA mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and `reason` `endorsement_required`, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\n","operationId":"createX402Mandate","parameters":["4d03e198-f18b-4a2c-9330-0a6dc7098631","1b7de978-b6fa-438e-808b-c10537cfa886"],"requestBody":"66baf6f2-5a84-473d-bc08-bc6a3c5581e8","responses":{"201":"54e88b31-644c-453e-bfd3-dfcf9edff71b","400":"4b5149b6-009a-4888-9616-91eca6d2ca0d","401":"a28f0c14-c831-4dd1-a00a-db942276b68e","403":"26a4312b-c7c4-452c-8cd7-b9e279c57f38","404":"e4ad6afe-478f-4fdd-aee3-e31b509e6d18","422":"12726ca3-0325-4749-9230-3d71c8a88a28","429":"431914fa-fff1-411f-899c-db47284eafdc","500":"685897cc-6551-400a-8266-95acf9aa81a5","503":"0389bc7d-d695-422f-8466-79b61620b46f"},"method":"post","type":"path","servers":["60fa85d1-fa15-41bf-a003-3083ff983109","e064d3b8-ad20-4649-b839-61c29944acca"],"security":["9d0155ab-0186-4033-97ea-b2479ae0da6f"],"path":"/payment-agents/{payment_agent_id}/x402/mandates","baseUrlOptions":["https://api.platform.dakota.xyz","https://api.platform.sandbox.dakota.xyz"],"title":"Create an x402 spend mandate (BETA)","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"4d03e198-f18b-4a2c-9330-0a6dc7098631":{"name":"x-idempotency-key","in":"header","required":true,"description":"Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.\n\nA key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a\nsuccessful (below 400) response. Repeating the same request (same JSON body, whatever the key order or\nwhitespace) with the same key within that window returns the original response with\n`X-Idempotent-Replayed: true` instead of executing the request again. Using the same key on the same\nendpoint with a different body returns `422` with problem type `idempotency-key-reused`; the request is\nnot executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason\ncan be corrected and retried under the same key. Request bodies that are not JSON (for example file\nuploads) are not compared.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.\n\nA key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a\nsuccessful (below 400) response. Repeating the same request (same JSON body, whatever the key order or\nwhitespace) with the same key within that window returns the original response with\n`X-Idempotent-Replayed: true` instead of executing the request again. Using the same key on the same\nendpoint with a different body returns `422` with problem type `idempotency-key-reused`; the request is\nnot executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason\ncan be corrected and retried under the same key. Request bodies that are not JSON (for example file\nuploads) are not compared.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"1b7de978-b6fa-438e-808b-c10537cfa886":{"name":"payment_agent_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["asset","network","max_per_call"],"properties":{"asset":{"type":"string","description":"Asset symbol. Only `USDC` is supported in this release; any other value is refused with a 400, since such a mandate could never be used.\n","isRequired":true,"uniqueKey":"asset","typeLabel":"string"},"network":{"type":"string","description":"Network the mandate covers, e.g. base-sepolia. Only Base and Base Sepolia are supported.","isRequired":true,"uniqueKey":"network","typeLabel":"string"},"max_per_call":{"type":"string","description":"Per-authorization ceiling, in atomic units.","isRequired":true,"uniqueKey":"max_per_call","typeLabel":"string"},"max_per_window":{"type":"string","description":"Ceiling on total committed spend across ALL payees in one rolling window, in atomic units. Omit for unbounded (discouraged).\n","uniqueKey":"max_per_window","typeLabel":"string"},"window_seconds":{"type":"integer","description":"Rolling aggregate window. Defaults to 24h.","uniqueKey":"window_seconds","typeLabel":"integer"},"max_calls_per_window":{"type":"integer","description":"Optional cap on authorizations per window. 0 is no cap.","uniqueKey":"max_calls_per_window","typeLabel":"integer"},"valid_for_seconds":{"type":"integer","description":"Mandate lifetime from now. Defaults to 30 days.","uniqueKey":"valid_for_seconds","typeLabel":"integer"},"payee_policy":{"type":"object","description":"What an x402 mandate may pay for, beyond its budget. Omit the whole object to leave the budget as the only control.\n`mode` is required when the object is present, and the list must match it: `address_allowlist` needs `addresses` and reads no domains, `domain_allowlist` needs `domains` and reads no addresses, and `any_screened` enforces neither, so it carries no list. A policy that breaks those rules is refused with a 400 rather than stored as a restriction nothing applies.\n`any_screened` accepts any payee that passes address screening. `address_allowlist` pins the payee address itself. `domain_allowlist` pins the RESOURCE host the caller names when it asks for a signature - the readable form, since an operator approves \"any metered API under this vendor's domain\" rather than a hex address. Note that it bounds the resource, not the payee: a seller who prices one resource can be paid for it whatever address it nominates.\n","required":["mode"],"properties":{"mode":{"type":"string","enum":["any_screened","address_allowlist","domain_allowlist"],"isRequired":true,"uniqueKey":"payee_policy.mode","typeLabel":"enum\u003cstring>"},"addresses":{"type":"array","description":"Payee addresses. Required for address_allowlist, and refused otherwise.","items":{"type":"string","uniqueKey":"payee_policy.addresses.items.[INDEX]","typeLabel":"string"},"uniqueKey":"payee_policy.addresses","typeLabel":"string[]"},"domains":{"type":"array","description":"Resource host patterns. Required for domain_allowlist, and refused otherwise. An exact host, or a \"*.example.com\" suffix.\n","items":{"type":"string","uniqueKey":"payee_policy.domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"payee_policy.domains","typeLabel":"string[]"}},"uniqueKey":"payee_policy","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"asset":"USDC","network":"base-sepolia","max_per_call":"500000","max_per_window":"2000000","window_seconds":3600,"payee_policy":{"mode":"domain_allowlist","domains":["*.marketpulse.example"]}},"examples":{"Example":{"title":"Example","value":{"asset":"USDC","network":"base-sepolia","max_per_call":"500000","max_per_window":"2000000","window_seconds":3600,"payee_policy":{"mode":"domain_allowlist","domains":["*.marketpulse.example"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"54e88b31-644c-453e-bfd3-dfcf9edff71b":{"description":"Mandate created","content":{"application/json":{"schema":{"type":"object","required":["id","agent_id","wallet_id","asset","network","max_per_call","window_seconds","payee_policy","valid_from","valid_until"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"agent_id":{"type":"string","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string"},"wallet_id":{"type":"string","isRequired":true,"uniqueKey":"wallet_id","typeLabel":"string"},"asset":{"type":"string","isRequired":true,"uniqueKey":"asset","typeLabel":"string"},"network":{"type":"string","isRequired":true,"uniqueKey":"network","typeLabel":"string"},"max_per_call":{"type":"string","isRequired":true,"uniqueKey":"max_per_call","typeLabel":"string"},"window_seconds":{"type":"integer","isRequired":true,"uniqueKey":"window_seconds","typeLabel":"integer"},"payee_policy":{"type":"object","description":"What an x402 mandate may pay for, beyond its budget. Omit the whole object to leave the budget as the only control.\n`mode` is required when the object is present, and the list must match it: `address_allowlist` needs `addresses` and reads no domains, `domain_allowlist` needs `domains` and reads no addresses, and `any_screened` enforces neither, so it carries no list. A policy that breaks those rules is refused with a 400 rather than stored as a restriction nothing applies.\n`any_screened` accepts any payee that passes address screening. `address_allowlist` pins the payee address itself. `domain_allowlist` pins the RESOURCE host the caller names when it asks for a signature - the readable form, since an operator approves \"any metered API under this vendor's domain\" rather than a hex address. Note that it bounds the resource, not the payee: a seller who prices one resource can be paid for it whatever address it nominates.\n","required":["mode"],"properties":{"mode":{"type":"string","enum":["any_screened","address_allowlist","domain_allowlist"],"isRequired":true,"uniqueKey":"payee_policy.mode","typeLabel":"enum\u003cstring>"},"addresses":{"type":"array","description":"Payee addresses. Required for address_allowlist, and refused otherwise.","items":{"type":"string","uniqueKey":"payee_policy.addresses.items.[INDEX]","typeLabel":"string"},"uniqueKey":"payee_policy.addresses","typeLabel":"string[]"},"domains":{"type":"array","description":"Resource host patterns. Required for domain_allowlist, and refused otherwise. An exact host, or a \"*.example.com\" suffix.\n","items":{"type":"string","uniqueKey":"payee_policy.domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"payee_policy.domains","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"payee_policy","typeLabel":"object"},"valid_from":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"valid_from","typeLabel":"string\u003cdate-time>"},"valid_until":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"valid_until","typeLabel":"string\u003cdate-time>"},"max_per_window":{"type":"string","uniqueKey":"max_per_window","typeLabel":"string"},"max_calls_per_window":{"type":"integer","uniqueKey":"max_calls_per_window","typeLabel":"integer"},"revoked_at":{"type":"string","format":"date-time","description":"When the mandate was cancelled, or replaced by a newer mandate for the same asset and network. A revoked mandate authorizes nothing.\n","uniqueKey":"revoked_at","typeLabel":"string\u003cdate-time>"},"window_committed":{"type":"string","description":"Spend already committed on this mandate's budget in the window ending now, in atomic units: every authorization from the agent's x402 wallet in this asset and network over this mandate's `window_seconds`, whichever mandate issued it, counting outstanding holds as well as settled ones. It is the budget's figure, not this mandate's own: a replaced or cancelled mandate shows the same spend as the mandate in force, so never add it up across mandates.\n","uniqueKey":"window_committed","typeLabel":"string"},"window_calls":{"type":"integer","description":"Authorizations already issued in the current window, counted the same way as `window_committed`.\n","uniqueKey":"window_calls","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"2vWxX402Mandate000000000001","agent_id":"2vWxAgent000000000000000000","wallet_id":"2vWxWallet00000000000000000","asset":"USDC","network":"base-sepolia","max_per_call":"500000","max_per_window":"2000000","window_seconds":3600,"payee_policy":{"mode":"domain_allowlist","domains":["*.marketpulse.example"]},"valid_from":"2026-09-08T00:00:00Z","valid_until":"2026-10-08T00:00:00Z","window_committed":"100000","window_calls":1},"examples":{"Example":{"title":"Example","value":{"id":"2vWxX402Mandate000000000001","agent_id":"2vWxAgent000000000000000000","wallet_id":"2vWxWallet00000000000000000","asset":"USDC","network":"base-sepolia","max_per_call":"500000","max_per_window":"2000000","window_seconds":3600,"payee_policy":{"mode":"domain_allowlist","domains":["*.marketpulse.example"]},"valid_from":"2026-09-08T00:00:00Z","valid_until":"2026-10-08T00:00:00Z","window_committed":"100000","window_calls":1}}},"exampleType":"examples"}},"exampleType":"examples"},"4b5149b6-009a-4888-9616-91eca6d2ca0d":{"description":"Malformed agent id or mandate request, an unsupported asset or network, or the agent is not active; or `endorsement_required` (an API key of a client with governance enforcement on)\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"a28f0c14-c831-4dd1-a00a-db942276b68e":{"description":"Missing or invalid credentials\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"26a4312b-c7c4-452c-8cd7-b9e279c57f38":{"description":"The caller lacks the permission this route requires\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"e4ad6afe-478f-4fdd-aee3-e31b509e6d18":{"description":"Agentic payments are not enabled for the client, x402 is not enabled for the agent (enable it with POST /payment-agents/{payment_agent_id}/x402), or the agent was not found\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"12726ca3-0325-4749-9230-3d71c8a88a28":{"description":"Unprocessable — the `X-Idempotency-Key` was already used on this endpoint with a different request body\n(problem type `idempotency-key-reused`). The request was not executed and the original response was not replayed.\nResend the original body to receive the original response, or use a new key to make a new request.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"431914fa-fff1-411f-899c-db47284eafdc":{"description":"Too many requests\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"685897cc-6551-400a-8266-95acf9aa81a5":{"description":"Internal error\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"},"0389bc7d-d695-422f-8466-79b61620b46f":{"description":"Whether the client is under governance enforcement could not be read; nothing was stored. Retry the request.\n","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status"],"description":"Error response following RFC 9457 Problem Details.\nPublic API error responses use this format.\n","example":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"},"properties":{"type":{"type":"string","format":"uri","description":"URI reference identifying the problem type.\nResolves to human-readable documentation.\n","example":"https://docs.dakota.xyz/api-reference/errors#not-found","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"Short, human-readable summary of the problem type. Stable across occurrences.","example":"Customer Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code for this occurrence.","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence.","example":"Customer cst_2abc123 was not found in your organization.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"The request path that triggered this error.","example":"https://api.platform.dakota.xyz/customers/cst_2abc123","uniqueKey":"instance","typeLabel":"string\u003curi>"},"request_id":{"type":"string","description":"Unique request identifier. Include when contacting support.","example":"req_7f3a8b2c","uniqueKey":"request_id","typeLabel":"string"},"errors":{"type":"array","description":"Field-level validation errors (present for validation failures).","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Field path using dot notation for nested fields.","example":"bank_account.routing_number","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description of the field error.","example":"Routing number must be exactly 9 digits","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code for this field.","example":"invalid_format","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"},"resolution_url":{"type":"string","format":"uri","description":"A link the customer can follow to CLEAR this error, present only on\nproblems with a concrete self-service remedy.\n\nToday this is returned by\n`#terms-not-accepted`, where it points at the hosted flow in which\nthe outstanding agreement can be signed. The link is token-gated and\nusable as-is — send the customer to it directly rather than parsing\nit out of `detail`.\n","example":"https://onboarding.dakota.xyz/applications/2abc123?token=tok_7f3a8b2c","uniqueKey":"resolution_url","typeLabel":"string\u003curi>"},"user_message":{"type":"string","description":"A plain-language rendition of `detail` written for the end\ncustomer, present when one exists for this error. `detail` names\nrequest fields and actions so a machine caller (such as a payment\nagent drafting proposals) can self-correct; `user_message` says the\nsame thing without API vocabulary. Clients that relay errors into a\nhuman surface (chat, email, UI) should show `user_message` when\npresent and fall back to `detail`.\n","example":"ACH payments pay out USD, so a USDC payout isn't possible on this rail. Change the payout currency to USD and try again.","uniqueKey":"user_message","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable code for why the request was refused,\npresent only when Dakota has a typed reason for this error. Branch\non `reason` rather than parsing `detail`.\n\nWhen `reason` is a value from the table below other than\n`signature_required` and `immutable_field`, `detail` is text Dakota\nwrites for that reason, never a partner's or a bank's wording. For\nthose two, `detail` is the text written for that specific refusal.\nIn every case the wording can change, so do not parse it.\n\nThis is an open set: new values are added over time and a value is\nnever repurposed, so treat an unrecognized `reason` as absent.\n\nWhich operations return it today:\n\n- `createAccount` (onramp, offramp and swap) and `createTransaction`\n (a one-off transaction creates an account): every value in the\n table except `immutable_field`; `signature_required` comes from\n `createTransaction` only.\n- `updateAccount`: `field_invalid` (a developer fee that is out of\n range), `resource_not_found`, and `immutable_field` (the change\n would alter the account's routing; create a new account instead).\n- `deleteAccount`: `resource_not_found`.\n- `createWalletTransaction` and `signWalletTypedData`:\n `check_unavailable` (503) when the address screen could not run.\n- `deletePolicy`: `policy_attached` (409, under governance\n enforcement) when a wallet still holds the policy.\n- Every operation authenticated with an API key:\n `api_key_expired` (401) and `ip_not_allowed` (403).\n- `createInstructions`: a payment-agent instruction that creates an\n account fails with the same `reason` values as `createAccount`,\n but `params.field` is never returned there: the response carries\n the other `params` keys only, because this operation has no\n public field names to map to.\n- Other operations may also set `reason`. Treat a `reason` you do\n not recognize as absent, as above, and never assume an operation\n that is not listed here omits it.\n\n| `reason` | Meaning | `params` |\n| --- | --- | --- |\n| `field_required` | A required request field is missing. | `field` |\n| `field_invalid` | A field is present but unusable. | `field`, `constraint`, `rail` |\n| `field_too_long` | A field is longer than the rail allows. | `field`, `max`, `actual`, `rail` |\n| `field_too_short` | A field is shorter than the rail allows. | `field`, `min`, `actual` |\n| `address_incomplete` | An address lacks parts the route needs. | `subject`, `fields` |\n| `unsupported_network` | The network is not supported. | `network` |\n| `unsupported_asset` | The asset does not exist on the network. | `asset`, `network` |\n| `no_route_available` | No payment route covers the request. | `direction`, `rail`, `currency`, `network` |\n| `onboarding_required` | The customer has not completed onboarding for a capability. | `capability` |\n| `entity_not_active` | Onboarding for a capability exists but is not yet usable. | `capability`, `status` |\n| `destination_unreachable` | The destination cannot be reached over the requested rail. | `rail`, `alternative`, `direction` |\n| `limit_exceeded` | An amount exceeds a ceiling. | `limit`, `max`, `configured`, `currency` |\n| `resource_not_found` | The named resource does not exist. | `resource` |\n| `duplicate_resource` | A matching resource already exists. | `resource` |\n| `request_rejected` | The request was refused and the reason is not disclosed. | none |\n| `signature_required` | The request must be signed. | none |\n| `immutable_field` | The field cannot be changed on an existing account; create a new one. | none |\n| `endorsement_required` | The signer-group change needs signatures from the group's governing members. Also returned, under governance enforcement, when an API key creates an x402 spend mandate. Also returned, under governance enforcement, when an `operate` API key sets an account's refund wallet (`return_address` or `return_crypto_address`) to an address that is not one of the customer's saved crypto destinations on the same network: save it as a crypto destination first. | none |\n| `insufficient_endorsements` | The signatures do not meet the signer group's governance quorum (403). When `params` are present, the group `signer_group_id` got `have` of the `need` distinct governing members it requires. When they are absent, no count is reported; usually no signature was counted at all, because one did not verify over the request's intent with the key of a member of a group allowed to endorse it, came from a payment-agent or card-settlement key, or repeated a signer. | `signer_group_id`, `have`, `need` (all or none) |\n| `webauthn_wrong_type` | A passkey signature was not an assertion: its `clientDataJSON.type` is not `webauthn.get` (for example, the output of a registration). Sign again with `navigator.credentials.get` (400 `validation_error`). | none |\n| `webauthn_user_not_present` | A passkey assertion lacks the user-present (UP) flag, so nobody confirmed it on the authenticator (400 `validation_error`). | none |\n| `webauthn_user_not_verified` | A passkey assertion lacks the user-verified (UV) flag. Refused only where Dakota enforces user verification (400 `validation_error`). | none |\n| `webauthn_rp_mismatch` | A passkey is bound to a relying party ID that is not allowed. Refused only where Dakota enforces the RP ID check (400 `validation_error`). | none |\n| `webauthn_origin_mismatch` | A passkey assertion was made on an origin that is not allowed. Refused only where Dakota enforces the origin check (400 `validation_error`). | none |\n| `stale_signer_group_version` | The signer group changed since the signatures were made; read its `version` and sign again. | none |\n| `below_threshold` | The removal would leave the signer group below a threshold it must keep. | none |\n| `invalid_governing_group` | The governing signer group is missing or no longer valid. | none |\n| `check_unavailable` | A required safety check could not run, so nothing was sent; retry later with the same idempotency key. | none |\n| `api_key_expired` | The API key is past its `expires_at` (401). Use a current key. | none |\n| `ip_not_allowed` | The request came from an address outside the API key's `allowed_cidrs` (403). | none |\n| `session_required` | Only a person's own signed-in session may do this; an API key cannot. Nothing was changed. | none |\n| `unmeetable_signer_groups` | Governance enforcement cannot be turned on while the listed signer groups could never be governed under it. Nothing was changed. | none |\n| `policy_attached` | Under governance enforcement, a policy still attached to a wallet cannot be deleted (409). Nothing was changed. Detach it from each wallet first. `wallet_ids` lists up to 20 of the wallets, comma-separated; `wallet_count` is the total. | `wallet_ids`, `wallet_count` |\n","example":"field_too_long","uniqueKey":"reason","typeLabel":"string"},"code":{"type":"string","description":"A stable snake_case error code for the signer-group governance\nrefusals, equal to `reason` for them: `endorsement_required`,\n`insufficient_endorsements`, `stale_signer_group_version`,\n`below_threshold`, `invalid_governing_group` and `policy_attached`,\nand the passkey refusals of a signed request (`webauthn_wrong_type`,\n`webauthn_user_not_present`, `webauthn_user_not_verified`,\n`webauthn_rp_mismatch` and `webauthn_origin_mismatch`, on a 400\n`validation_error`). Absent for every other problem.\n","example":"insufficient_endorsements","uniqueKey":"code","typeLabel":"string"},"params":{"type":"object","description":"Parameters of `reason`. Every value is a string: a number, a\ntoken from a closed set, or the public name of a request field\n(`field` is expressed in this operation's request body, and is\nomitted when the offending value has no public name). Never free\ntext. Present only alongside `reason`, and only when the reason\nhas parameters.\n","additionalProperties":{"type":"string","uniqueKey":"params.additionalProperties","typeLabel":"string"},"example":{"field":"payment_reference","max":"35","actual":"40","rail":"swift"},"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.dakota.xyz/api-reference/errors#not-found","title":"Customer Not Found","status":404,"detail":"Customer cst_2abc123 was not found in your organization.","instance":"https://api.platform.dakota.xyz/customers/cst_2abc123","request_id":"req_7f3a8b2c"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9d0155ab-0186-4033-97ea-b2479ae0da6f":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"60fa85d1-fa15-41bf-a003-3083ff983109":{"url":"https://api.platform.dakota.xyz","description":"Production environment"},"e064d3b8-ad20-4649-b839-61c29944acca":{"url":"https://api.platform.sandbox.dakota.xyz","description":"Sandbox — safe for testing with simulated data"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"dakota-49818541","siteName":"Dakota","title":"Create an x402 spend mandate (BETA) - Dakota","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T17:01:07.568Z","originalFileLocation":"api-reference/agentic-payments/create-an-x402-spend-mandate-beta.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=\"dark\"}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=\"\u0026gt; Beta — early access. Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller\u0026#x27;s 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \u0026quot;100000\u0026quot; is $0.10). The budget belongs to the agent\u0026#x27;s x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent\u0026#x27;s live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate\u0026#x27;s window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent. A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reason endorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dakota\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an x402 spend mandate (BETA) - Dakota\">\u003cmeta data-mint-head property=\"og:description\" content=\"\u0026gt; Beta — early access. Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller\u0026#x27;s 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \u0026quot;100000\u0026quot; is $0.10). The budget belongs to the agent\u0026#x27;s x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent\u0026#x27;s live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate\u0026#x27;s window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent. A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reason endorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dakota\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dakota-49818541.mintlify.site/_mintlify/api/og/v2?division=Agentic+Payments\u0026amp;title=Create+an+x402+spend+mandate+%28BETA%29\u0026amp;description=%3E+**Beta**+%E2%80%94+early+access.%0A%0ACreates+the+standing+allowance+an+agent+pays+x402-metered+resources+under.+Unlike+a+payment+mandate+this+authorizes+a+BUDGET+rather+\u0026amp;theme=b4f99b33160b9781c71dd798\u0026amp;signature=dae3f42d63be4805bd47b939fbd2e4b295c9a95de77164b6488558d6a440dc42\">\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=\"Create an x402 spend mandate (BETA) - Dakota\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"\u0026gt; Beta — early access. Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller\u0026#x27;s 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \u0026quot;100000\u0026quot; is $0.10). The budget belongs to the agent\u0026#x27;s x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent\u0026#x27;s live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate\u0026#x27;s window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent. A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reason endorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dakota-49818541.mintlify.site/_mintlify/api/og/v2?division=Agentic+Payments\u0026amp;title=Create+an+x402+spend+mandate+%28BETA%29\u0026amp;description=%3E+**Beta**+%E2%80%94+early+access.%0A%0ACreates+the+standing+allowance+an+agent+pays+x402-metered+resources+under.+Unlike+a+payment+mandate+this+authorizes+a+BUDGET+rather+\u0026amp;theme=b4f99b33160b9781c71dd798\u0026amp;signature=dae3f42d63be4805bd47b939fbd2e4b295c9a95de77164b6488558d6a440dc42\">\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/dakota-49818541/PW4ddHpkUE3rJR0e/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dakota\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8e4410\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dakota.xyz/#organization\",\"name\":\"Dakota\",\"url\":\"https://docs.dakota.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dakota-49818541/-tkRmX-DtPxqfDgt/images/dakota-logo-black.png?fit=max\u0026auto=format\u0026n=-tkRmX-DtPxqfDgt\u0026q=85\u0026s=c409f7b8cec2e984bd0c79735f637bfe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dakota.xyz#website\",\"name\":\"Dakota\",\"url\":\"https://docs.dakota.xyz\",\"publisher\":{\"@id\":\"https://docs.dakota.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta#webpage\",\"url\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta\",\"name\":\"Create an x402 spend mandate (BETA)\",\"description\":\"> Beta — early access. Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller's 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \\\"100000\\\" is $0.10). The budget belongs to the agent's x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent's live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate's window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent. A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reason endorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\",\"dateModified\":\"2026-11-19T17:01:07.568Z\",\"isPartOf\":{\"@id\":\"https://docs.dakota.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agentic Payments\",\"item\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-a-hosted-payment-agent-beta\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an x402 spend mandate (BETA)\",\"item\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta#apireference\",\"headline\":\"Create an x402 spend mandate (BETA)\",\"name\":\"Create an x402 spend mandate (BETA)\",\"description\":\"> Beta — early access. Creates the standing allowance an agent pays x402-metered resources under. Unlike a payment mandate this authorizes a BUDGET rather than a payee: x402 payees are discovered at request time from a seller's 402 response, so the controls are a per-call ceiling plus a rolling aggregate across every payee. Amounts are atomic units of the asset (USDC has 6 decimals, so \\\"100000\\\" is $0.10). The budget belongs to the agent's x402 wallet in that asset on that network, not to one mandate. A new mandate replaces the agent's live mandate for the same asset and network: the old one is cancelled in the same step (its revoked_at is set) and never comes back into force, even after the new one expires. Spend already committed in the new mandate's window counts against it, whichever mandate authorized it, so lowering a limit over the same or a longer window never frees up more spend. A shorter window looks back only that far: replacing 100 per day with 50 per hour allows 50 in the next hour, whatever the day has already spent. A mandate is in force as soon as it is created, and the agent pays under it with no further approval. So for a client with governance enforcement on, an API key cannot create or replace one: the request is refused with 400 and reason endorsement_required, nothing is stored, and the mandate in force is left as it is. A signed-in team member whose role can create and approve mandates can still create it, as can any caller of a client without enforcement. Listing and cancelling mandates, and paying under one, are not affected.\",\"url\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dakota.xyz/api-reference/agentic-payments/create-an-x402-spend-mandate-beta#webpage\"},\"dateModified\":\"2026-11-19T17:01:07.568Z\",\"publisher\":{\"@id\":\"https://docs.dakota.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dakota.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dakota\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dakota\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta.md","siteName":"Dakota","nav":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://support.dakota.xyz"},{"anchor":"Contact us","icon":"envelope","href":"https://dakota.xyz/talk-to-sales"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/try-it-now"}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Errors","href":"/api-reference/errors"},{"title":"State Lifecycles","href":"/api-reference/state-lifecycles"}]},{"group":"Customers","pages":[{"title":"List all customer records","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers","href":"/api-reference/customers/list-all-customer-records"},{"title":"Create a customer record","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers","href":"/api-reference/customers/create-a-customer-record"},{"title":"Update sub-client association for a customer","deprecated":true,"version":null,"openapi":"/openapi.yaml patch /customers/{customer_id}/sub-client","href":"/api-reference/customers/update-sub-client-association-for-a-customer"},{"title":"Retrieve a customer record by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}","href":"/api-reference/customers/retrieve-a-customer-record-by-id"},{"title":"Delete a customer record","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /customers/{customer_id}","href":"/api-reference/customers/delete-a-customer-record"},{"title":"List available SWIFT FX currencies","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}/fx-currencies","href":"/api-reference/customers/list-available-swift-fx-currencies"},{"title":"List a customer's capabilities and what's needed to unlock them","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}/capabilities","href":"/api-reference/customers/list-a-customers-capabilities-and-whats-needed-to-unlock-them"},{"title":"Get a customer's limits","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}/limits","href":"/api-reference/customers/get-a-customers-limits"},{"title":"Get sub-client summary","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/sub-client-summary","href":"/api-reference/customers/get-sub-client-summary"},{"title":"Mint a fresh application link for re-engaging an approved customer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers/{customer_id}/re-engagement","href":"/api-reference/customers/mint-a-fresh-application-link-for-re-engaging-an-approved-customer"},{"title":"Withdraw a customer's onboarding application","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers/{customer_id}/applications/{application_id}/withdraw","href":"/api-reference/customers/withdraw-a-customers-onboarding-application"}]},{"group":"Wallets","pages":[{"title":"List wallets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /wallets","href":"/api-reference/wallets/list-wallets"},{"title":"Create a new wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml post /wallets","href":"/api-reference/wallets/create-a-new-wallet"},{"title":"Get a single wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml get /wallets/{wallet_id}","href":"/api-reference/wallets/get-a-single-wallet"},{"title":"Get policies attached to a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml get /wallets/{wallet_id}/policies","href":"/api-reference/wallets/get-policies-attached-to-a-wallet"},{"title":"Get wallet balances across all networks","deprecated":null,"version":null,"openapi":"/openapi.yaml get /wallets/{wallet_id}/balances","href":"/api-reference/wallets/get-wallet-balances-across-all-networks"},{"title":"Sign typed data with a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml post /wallets/{wallet_id}/sign","href":"/api-reference/wallets/sign-typed-data-with-a-wallet"},{"title":"Send a transaction from a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml post /wallets/{wallet_id}/transactions","href":"/api-reference/wallets/send-a-transaction-from-a-wallet"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.yaml get /transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create a one-off transfer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /transactions","href":"/api-reference/transactions/create-a-one-off-transfer"},{"title":"Request a directional FX quote or estimate","deprecated":null,"version":null,"openapi":"/openapi.yaml post /fx/quotes","href":"/api-reference/transactions/request-a-directional-fx-quote-or-estimate"},{"title":"Get an owned one-off FX quote","deprecated":null,"version":null,"openapi":"/openapi.yaml get /fx/quotes/{quote_id}","href":"/api-reference/transactions/get-an-owned-one-off-fx-quote"},{"title":"Get a transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml get /transactions/{transaction_id}","href":"/api-reference/transactions/get-a-transaction"},{"title":"Get the request for information about a transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml get /transactions/{transaction_id}/rfi","href":"/api-reference/transactions/get-the-request-for-information-about-a-transaction"},{"title":"Answer a request for information about a transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml post /transactions/{transaction_id}/rfi/response","href":"/api-reference/transactions/answer-a-request-for-information-about-a-transaction"},{"title":"Cancel a transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml post /transactions/{transaction_id}/cancellations","href":"/api-reference/transactions/cancel-a-transaction"},{"title":"Get an upload URL for a file for a request for information","deprecated":null,"version":null,"openapi":"/openapi.yaml post /transactions/{transaction_id}/rfi/document-uploads","href":"/api-reference/transactions/get-an-upload-url-for-a-file-for-a-request-for-information"}]},{"group":"Recipients","pages":[{"title":"Get a specific recipient","deprecated":null,"version":null,"openapi":"/openapi.yaml get /recipients/{recipient_id}","href":"/api-reference/recipients/get-a-specific-recipient"},{"title":"Update a recipient","deprecated":null,"version":null,"openapi":"/openapi.yaml put /recipients/{recipient_id}","href":"/api-reference/recipients/update-a-recipient"},{"title":"Delete a recipient","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /recipients/{recipient_id}","href":"/api-reference/recipients/delete-a-recipient"},{"title":"Delete a destination","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /recipients/{recipient_id}/destinations/{destination_id}","href":"/api-reference/recipients/delete-a-destination"},{"title":"Update a destination's supported currencies","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /recipients/{recipient_id}/destinations/{destination_id}","href":"/api-reference/recipients/update-a-destinations-supported-currencies"},{"title":"List a customer's recipients","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}/recipients","href":"/api-reference/recipients/list-a-customers-recipients"},{"title":"Create a new recipient","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers/{customer_id}/recipients","href":"/api-reference/recipients/create-a-new-recipient"},{"title":"List destinations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /recipients/{recipient_id}/destinations","href":"/api-reference/recipients/list-destinations"},{"title":"Add a destination for a recipient","deprecated":null,"version":null,"openapi":"/openapi.yaml post /recipients/{recipient_id}/destinations","href":"/api-reference/recipients/add-a-destination-for-a-recipient"}]},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.yaml get /accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Create an account","deprecated":null,"version":null,"openapi":"/openapi.yaml post /accounts","href":"/api-reference/accounts/create-an-account"},{"title":"Get an account","deprecated":null,"version":null,"openapi":"/openapi.yaml get /accounts/{account_id}","href":"/api-reference/accounts/get-an-account"},{"title":"Delete an account","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /accounts/{account_id}","href":"/api-reference/accounts/delete-an-account"},{"title":"Update an account","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /accounts/{account_id}","href":"/api-reference/accounts/update-an-account"}]},{"group":"Auto Transactions","pages":[{"title":"Get details of a specific auto account transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml get /auto-transactions/{auto_transaction_id}","href":"/api-reference/auto-transactions/get-details-of-a-specific-auto-account-transaction"},{"title":"List transactions that were created automatically by auto accounts","deprecated":null,"version":null,"openapi":"/openapi.yaml get /auto-transactions","href":"/api-reference/auto-transactions/list-transactions-that-were-created-automatically-by-auto-accounts"}]},{"group":"Onboarding","pages":[{"title":"Bulk import customers from Sumsub share tokens","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers/bulk-import-sumsub-tokens","href":"/api-reference/onboarding/bulk-import-customers-from-sumsub-share-tokens"},{"title":"Import customers from Persona Connect share tokens","deprecated":null,"version":null,"openapi":"/openapi.yaml post /customers/import-persona-tokens","href":"/api-reference/onboarding/import-customers-from-persona-connect-share-tokens"},{"title":"Update associated individual","deprecated":null,"version":null,"openapi":"/openapi.yaml put /applications/{application_id}/associated-individuals/{individual_id}","href":"/api-reference/onboarding/update-associated-individual"},{"title":"Remove associated individual from business application","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /applications/{application_id}/associated-individuals/{individual_id}","href":"/api-reference/onboarding/remove-associated-individual-from-business-application"},{"title":"Update business application details","deprecated":null,"version":null,"openapi":"/openapi.yaml put /applications/{application_id}/business-details","href":"/api-reference/onboarding/update-business-application-details"},{"title":"Get EDD record for application","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}/edd","href":"/api-reference/onboarding/get-edd-record-for-application"},{"title":"Create or update EDD record","deprecated":null,"version":null,"openapi":"/openapi.yaml put /applications/{application_id}/edd","href":"/api-reference/onboarding/create-or-update-edd-record"},{"title":"Update individual application details","deprecated":null,"version":null,"openapi":"/openapi.yaml put /applications/{application_id}/individual-details","href":"/api-reference/onboarding/update-individual-application-details"},{"title":"Get an onboarding application","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}","href":"/api-reference/onboarding/get-an-onboarding-application"},{"title":"What this application still needs to accept, and who may accept it","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}/legal-acceptance","href":"/api-reference/onboarding/what-this-application-still-needs-to-accept-and-who-may-accept-it"},{"title":"Read a legal document as this application's customer is shown it","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}/legal-documents/{document_key}","href":"/api-reference/onboarding/read-a-legal-document-as-this-applications-customer-is-shown-it"},{"title":"Download a document","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}/documents/{document_id}","href":"/api-reference/onboarding/download-a-document"},{"title":"Delete an onboarding document","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /applications/{application_id}/documents/{document_id}","href":"/api-reference/onboarding/delete-an-onboarding-document"},{"title":"Get a Persona import job with per-token results","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/persona-import-jobs/{job_id}","href":"/api-reference/onboarding/get-a-persona-import-job-with-per-token-results"},{"title":"List all onboarding applications","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications","href":"/api-reference/onboarding/list-all-onboarding-applications"},{"title":"List Persona import jobs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/persona-import-jobs","href":"/api-reference/onboarding/list-persona-import-jobs"},{"title":"Answer a request for information","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{id}/rfi/resubmit","href":"/api-reference/onboarding/answer-a-request-for-information"},{"title":"List all documents for an application","deprecated":null,"version":null,"openapi":"/openapi.yaml get /applications/{application_id}/documents","href":"/api-reference/onboarding/list-all-documents-for-an-application"},{"title":"Upload an application document","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/documents","href":"/api-reference/onboarding/upload-an-application-document"},{"title":"Submit an application for verification","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/submissions","href":"/api-reference/onboarding/submit-an-application-for-verification"},{"title":"Submit an attestation for an application","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/attestations","href":"/api-reference/onboarding/submit-an-attestation-for-an-application"},{"title":"Create an application document upload session","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/document-uploads","href":"/api-reference/onboarding/create-an-application-document-upload-session"},{"title":"Add associated individual to business application","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/associated-individuals","href":"/api-reference/onboarding/add-associated-individual-to-business-application"},{"title":"Verify a document upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/documents/{document_id}/verifications","href":"/api-reference/onboarding/verify-a-document-upload"},{"title":"Upload an individual document","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/associated-individuals/{individual_id}/documents","href":"/api-reference/onboarding/upload-an-individual-document"},{"title":"Get presigned URL for individual document upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /applications/{application_id}/associated-individuals/{individual_id}/document-uploads","href":"/api-reference/onboarding/get-presigned-url-for-individual-document-upload"}]},{"group":"Policies","pages":[{"title":"List all policies","deprecated":null,"version":null,"openapi":"/openapi.yaml get /policies","href":"/api-reference/policies/list-all-policies"},{"title":"Create a new policy","deprecated":null,"version":null,"openapi":"/openapi.yaml post /policies","href":"/api-reference/policies/create-a-new-policy"},{"title":"Remove a rule from a policy","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /policies/{policy_id}/rules/{rule_id}","href":"/api-reference/policies/remove-a-rule-from-a-policy"},{"title":"Update an existing rule","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /policies/{policy_id}/rules/{rule_id}","href":"/api-reference/policies/update-an-existing-rule"},{"title":"Attach policy to a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml put /policies/{policy_id}/wallets/{wallet_id}","href":"/api-reference/policies/attach-policy-to-a-wallet"},{"title":"Detach policy from a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /policies/{policy_id}/wallets/{wallet_id}","href":"/api-reference/policies/detach-policy-from-a-wallet"},{"title":"Get a specific policy","deprecated":null,"version":null,"openapi":"/openapi.yaml get /policies/{policy_id}","href":"/api-reference/policies/get-a-specific-policy"},{"title":"Delete a policy","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /policies/{policy_id}","href":"/api-reference/policies/delete-a-policy"},{"title":"Get wallets attached to a policy","deprecated":null,"version":null,"openapi":"/openapi.yaml get /policies/{policy_id}/wallets","href":"/api-reference/policies/get-wallets-attached-to-a-policy"},{"title":"Add a new rule to a policy","deprecated":null,"version":null,"openapi":"/openapi.yaml post /policies/{policy_id}/rules","href":"/api-reference/policies/add-a-new-rule-to-a-policy"}]},{"group":"Signer Groups","pages":[{"title":"Get signer groups for the authenticated client","deprecated":null,"version":null,"openapi":"/openapi.yaml get /signer-groups","href":"/api-reference/signer-groups/get-signer-groups-for-the-authenticated-client"},{"title":"Create a new signer group","deprecated":null,"version":null,"openapi":"/openapi.yaml post /signer-groups","href":"/api-reference/signer-groups/create-a-new-signer-group"},{"title":"Create a new signer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /signers","href":"/api-reference/signer-groups/create-a-new-signer"},{"title":"Update a signer group's governance","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /signer-groups/{signer_group_id}/governance","href":"/api-reference/signer-groups/update-a-signer-groups-governance"},{"title":"Attach a signer group to a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml put /wallets/{wallet_id}/signer-groups/{signer_group_id}","href":"/api-reference/signer-groups/attach-a-signer-group-to-a-wallet"},{"title":"Detach a signer group from a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /wallets/{wallet_id}/signer-groups/{signer_group_id}","href":"/api-reference/signer-groups/detach-a-signer-group-from-a-wallet"},{"title":"Get a signer group by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /signer-groups/{signer_group_id}","href":"/api-reference/signer-groups/get-a-signer-group-by-id"},{"title":"Get wallets attached to a signer group","deprecated":null,"version":null,"openapi":"/openapi.yaml get /signer-groups/{signer_group_id}/wallets","href":"/api-reference/signer-groups/get-wallets-attached-to-a-signer-group"},{"title":"Get signer groups attached to a wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml get /wallets/{wallet_id}/signer-groups","href":"/api-reference/signer-groups/get-signer-groups-attached-to-a-wallet"},{"title":"Remove a signer from a signer group","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /signer-groups/{signer_group_id}/signers/{signer_id}","href":"/api-reference/signer-groups/remove-a-signer-from-a-signer-group"},{"title":"Delete a signer by public key","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /signers/{public_key}","href":"/api-reference/signer-groups/delete-a-signer-by-public-key"},{"title":"Add a signer to a signer group","deprecated":null,"version":null,"openapi":"/openapi.yaml post /signer-groups/{signer_group_id}/signers","href":"/api-reference/signer-groups/add-a-signer-to-a-signer-group"},{"title":"Remove signers from a signer group, with signatures","deprecated":null,"version":null,"openapi":"/openapi.yaml post /signer-groups/{signer_group_id}/signer-removals","href":"/api-reference/signer-groups/remove-signers-from-a-signer-group-with-signatures"}]},{"group":"Authentication","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api-keys","href":"/api-reference/authentication/list-api-keys"},{"title":"Create a new API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys","href":"/api-reference/authentication/create-a-new-api-key"},{"title":"Delete all API keys","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api-keys","href":"/api-reference/authentication/delete-all-api-keys"},{"title":"Create an API key for a client (Admin only)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys/admin","href":"/api-reference/authentication/create-an-api-key-for-a-client-admin-only"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api-keys/{api_key_id}","href":"/api-reference/authentication/delete-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api-keys/{api_key_id}","href":"/api-reference/authentication/update-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api-keys/{api_key_id}/rotate","href":"/api-reference/authentication/rotate-an-api-key"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users","href":"/api-reference/users/list-users"},{"title":"Create a new user","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users","href":"/api-reference/users/create-a-new-user"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user_id}","href":"/api-reference/users/delete-a-user"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /users/{user_id}","href":"/api-reference/users/update-a-user"}]},{"group":"Webhooks","pages":[{"title":"List webhook targets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks/targets","href":"/api-reference/webhooks/list-webhook-targets"},{"title":"Create a webhook target","deprecated":null,"version":null,"openapi":"/openapi.yaml post /webhooks/targets","href":"/api-reference/webhooks/create-a-webhook-target"},{"title":"Get a webhook target","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks/targets/{webhook_target_id}","href":"/api-reference/webhooks/get-a-webhook-target"},{"title":"Delete a webhook target","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /webhooks/targets/{webhook_target_id}","href":"/api-reference/webhooks/delete-a-webhook-target"},{"title":"Update a webhook target","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /webhooks/targets/{webhook_target_id}","href":"/api-reference/webhooks/update-a-webhook-target"},{"title":"Get a webhook delivery record","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks/{event_id}","href":"/api-reference/webhooks/get-a-webhook-delivery-record"},{"title":"List webhook delivery history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks","href":"/api-reference/webhooks/list-webhook-delivery-history"},{"title":"Replay a webhook delivery","deprecated":null,"version":null,"openapi":"/openapi.yaml post /webhooks/events/{event_id}/replay","href":"/api-reference/webhooks/replay-a-webhook-delivery"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /events","href":"/api-reference/events/list-events"}]},{"group":"Info","pages":[{"title":"Get countries","deprecated":null,"version":null,"openapi":"/openapi.yaml get /capabilities/countries","href":"/api-reference/info/get-countries"},{"title":"Get supported blockchain networks","deprecated":null,"version":null,"openapi":"/openapi.yaml get /capabilities/networks","href":"/api-reference/info/get-supported-blockchain-networks"}]},{"group":"Sandbox","pages":[{"title":"Simulate an inbound payment event","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/simulate/inbound","href":"/api-reference/sandbox/simulate-an-inbound-payment-event"},{"title":"Simulate an onboarding state transition","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/simulate/onboarding","href":"/api-reference/sandbox/simulate-an-onboarding-state-transition"},{"title":"Simulate a card authorization","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/cards/simulate/transaction","href":"/api-reference/sandbox/simulate-a-card-authorization"},{"title":"Get simulation status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sandbox/simulations/{simulation_id}","href":"/api-reference/sandbox/get-simulation-status"},{"title":"List available simulation scenarios","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sandbox/scenarios","href":"/api-reference/sandbox/list-available-simulation-scenarios"},{"title":"Fund a sandbox wallet from the testnet faucet","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/wallets/{wallet_id}/faucet","href":"/api-reference/sandbox/fund-a-sandbox-wallet-from-the-testnet-faucet"},{"title":"Advance a paused simulation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/simulations/{simulation_id}/advance","href":"/api-reference/sandbox/advance-a-paused-simulation"},{"title":"Advance a simulated card transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sandbox/cards/simulate/transaction/{card_transaction_id}","href":"/api-reference/sandbox/advance-a-simulated-card-transaction"},{"title":"Advance a simulated card transaction (deprecated, use POST)","deprecated":true,"version":null,"openapi":"/openapi.yaml patch /sandbox/cards/simulate/transaction/{card_transaction_id}","href":"/api-reference/sandbox/advance-a-simulated-card-transaction-deprecated-use-post"}]},{"group":"Self Serve","pages":[{"title":"Create Stripe Checkout session for credit purchase","deprecated":null,"version":null,"openapi":"/openapi.yaml post /self-serve/credits/purchase","href":"/api-reference/self-serve/create-stripe-checkout-session-for-credit-purchase"},{"title":"Get prepaid credit balance","deprecated":null,"version":null,"openapi":"/openapi.yaml get /self-serve/credits/balance","href":"/api-reference/self-serve/get-prepaid-credit-balance"},{"title":"List prepaid credit ledger entries","deprecated":null,"version":null,"openapi":"/openapi.yaml get /self-serve/credits/ledger","href":"/api-reference/self-serve/list-prepaid-credit-ledger-entries"},{"title":"List available credit purchase tiers","deprecated":null,"version":null,"openapi":"/openapi.yaml get /self-serve/credits/tiers","href":"/api-reference/self-serve/list-available-credit-purchase-tiers"},{"title":"Get the self-serve client's pricing config (fee schedule)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /self-serve/credits/pricing","href":"/api-reference/self-serve/get-the-self-serve-clients-pricing-config-fee-schedule"}]},{"group":"Cards","pages":[{"title":"Report a card dispute, and optionally file it","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /card_dispute_reports","href":"/api-reference/cards/report-a-card-dispute-and-optionally-file-it"},{"title":"Get a cardholder","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /cardholders/{cardholder_id}","href":"/api-reference/cards/get-a-cardholder"},{"title":"Delete a cardholder","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml delete /cardholders/{cardholder_id}","href":"/api-reference/cards/delete-a-cardholder"},{"title":"Update a cardholder","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml patch /cardholders/{cardholder_id}","href":"/api-reference/cards/update-a-cardholder"},{"title":"Get a card","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /cards/{card_id}","href":"/api-reference/cards/get-a-card"},{"title":"Update a card","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml patch /cards/{card_id}","href":"/api-reference/cards/update-a-card"},{"title":"Replace a card's spend limit","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml put /cards/{card_id}/spend_limit","href":"/api-reference/cards/replace-a-cards-spend-limit"},{"title":"List a customer's persons","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /customers/{customer_id}/persons","href":"/api-reference/cards/list-a-customers-persons"},{"title":"Get a cardholder's application","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /cardholders/{cardholder_id}/application","href":"/api-reference/cards/get-a-cardholders-application"},{"title":"Get card art","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /card_art/{card_art_id}","href":"/api-reference/cards/get-card-art"},{"title":"Get a card transaction","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /card_transactions/{card_transaction_id}","href":"/api-reference/cards/get-a-card-transaction"},{"title":"List card art","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /card_art","href":"/api-reference/cards/list-card-art"},{"title":"List the card spend options available to the client","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /cards/spend_options","href":"/api-reference/cards/list-the-card-spend-options-available-to-the-client"},{"title":"List card transactions","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /card_transactions","href":"/api-reference/cards/list-card-transactions"},{"title":"Report a card found","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /cards/{card_id}/found_report","href":"/api-reference/cards/report-a-card-found"},{"title":"List cards","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /customers/{customer_id}/cards","href":"/api-reference/cards/list-cards"},{"title":"Create a card","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /customers/{customer_id}/cards","href":"/api-reference/cards/create-a-card"},{"title":"Create a card reveal session","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /cards/{card_id}/reveal_session","href":"/api-reference/cards/create-a-card-reveal-session"},{"title":"Report a card lost or stolen","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /cards/{card_id}/lost_stolen_report","href":"/api-reference/cards/report-a-card-lost-or-stolen"},{"title":"List cardholders","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /customers/{customer_id}/cardholders","href":"/api-reference/cards/list-cardholders"},{"title":"Create a cardholder","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /customers/{customer_id}/cardholders","href":"/api-reference/cards/create-a-cardholder"},{"title":"Get a wallet's card enablement","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml get /wallets/{wallet_id}/card_enablement","href":"/api-reference/cards/get-a-wallets-card-enablement"},{"title":"Enable card settlement on a wallet","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /wallets/{wallet_id}/card_enablement","href":"/api-reference/cards/enable-card-settlement-on-a-wallet"},{"title":"Submit requested information for a cardholder's application","deprecated":null,"version":null,"tag":"Sandbox only","openapi":"/openapi.yaml post /cardholders/{cardholder_id}/application/information","href":"/api-reference/cards/submit-requested-information-for-a-cardholders-application"}]},{"group":"RD Marketing Fee","pages":[{"title":"List the wallets you hold outside Dakota","deprecated":null,"version":null,"openapi":"/openapi.yaml get /rd-marketing-fee/declared-wallets","href":"/api-reference/rd-marketing-fee/list-the-wallets-you-hold-outside-dakota"},{"title":"Declare a wallet you hold outside Dakota","deprecated":null,"version":null,"openapi":"/openapi.yaml post /rd-marketing-fee/declared-wallets","href":"/api-reference/rd-marketing-fee/declare-a-wallet-you-hold-outside-dakota"},{"title":"Get your payout destination for one deployment","deprecated":null,"version":null,"openapi":"/openapi.yaml get /rd-marketing-fee/payout-destinations/{asset}/{network}","href":"/api-reference/rd-marketing-fee/get-your-payout-destination-for-one-deployment"},{"title":"Register your payout destination for one deployment","deprecated":null,"version":null,"openapi":"/openapi.yaml put /rd-marketing-fee/payout-destinations/{asset}/{network}","href":"/api-reference/rd-marketing-fee/register-your-payout-destination-for-one-deployment"},{"title":"One month of this client's marketing-fee statement","deprecated":null,"version":null,"openapi":"/openapi.yaml get /rd-marketing-fee/statements/{month}","href":"/api-reference/rd-marketing-fee/one-month-of-this-clients-marketing-fee-statement"},{"title":"Remove a wallet you hold outside Dakota","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /rd-marketing-fee/declared-wallets/{address}","href":"/api-reference/rd-marketing-fee/remove-a-wallet-you-hold-outside-dakota"},{"title":"The months this client has a marketing-fee statement for","deprecated":null,"version":null,"openapi":"/openapi.yaml get /rd-marketing-fee/statements","href":"/api-reference/rd-marketing-fee/the-months-this-client-has-a-marketing-fee-statement-for"},{"title":"Get your RD marketing-fee payout destination","deprecated":null,"version":null,"openapi":"/openapi.yaml get /rd-marketing-fee/payout-destination","href":"/api-reference/rd-marketing-fee/get-your-rd-marketing-fee-payout-destination"},{"title":"Register your RD marketing-fee payout destination","deprecated":null,"version":null,"openapi":"/openapi.yaml put /rd-marketing-fee/payout-destination","href":"/api-reference/rd-marketing-fee/register-your-rd-marketing-fee-payout-destination"}]},{"group":"Agentic Payments","pages":[{"title":"Create a hosted payment agent (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents","href":"/api-reference/agentic-payments/create-a-hosted-payment-agent-beta"},{"title":"Accept instructions — actuate proposals (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /instructions","href":"/api-reference/agentic-payments/accept-instructions-—-actuate-proposals-beta"},{"title":"List the calling client's scheduled payments (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /scheduled-payments","href":"/api-reference/agentic-payments/list-the-calling-clients-scheduled-payments-beta"},{"title":"Schedule a payment directly (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /scheduled-payments","href":"/api-reference/agentic-payments/schedule-a-payment-directly-beta"},{"title":"Get a hosted payment agent (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /payment-agents/{payment_agent_id}","href":"/api-reference/agentic-payments/get-a-hosted-payment-agent-beta"},{"title":"List an agent's x402 authorization holds (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /payment-agents/{payment_agent_id}/x402/holds","href":"/api-reference/agentic-payments/list-an-agents-x402-authorization-holds-beta"},{"title":"Live progress of an in-flight drafting turn (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /payment-agents/{payment_agent_id}/proposals/progress","href":"/api-reference/agentic-payments/live-progress-of-an-in-flight-drafting-turn-beta"},{"title":"Get an instruction (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /instructions/{instruction_id}","href":"/api-reference/agentic-payments/get-an-instruction-beta"},{"title":"Get the client's registered agentic policy (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /agentic-policy","href":"/api-reference/agentic-payments/get-the-clients-registered-agentic-policy-beta"},{"title":"Register the client's agentic policy (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml put /agentic-policy","href":"/api-reference/agentic-payments/register-the-clients-agentic-policy-beta"},{"title":"Get an agent's x402 wallet (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /payment-agents/{payment_agent_id}/x402","href":"/api-reference/agentic-payments/get-an-agents-x402-wallet-beta"},{"title":"Enable x402 payments for an agent (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402","href":"/api-reference/agentic-payments/enable-x402-payments-for-an-agent-beta"},{"title":"Revoke a hosted agent (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/revoke","href":"/api-reference/agentic-payments/revoke-a-hosted-agent-beta"},{"title":"Draft payment proposals from a conversation (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/proposals","href":"/api-reference/agentic-payments/draft-payment-proposals-from-a-conversation-beta"},{"title":"List an agent's x402 spend mandates (BETA)","description":"> **Beta** — early access.\n\nLists the agent's x402 mandates with their committed spend in the current window. Committed spend counts outstanding authorizations as well as settled ones - an issued x402 signature is spendable money whether or not it has reached the chain.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /payment-agents/{payment_agent_id}/x402/mandates","href":"/api-reference/agentic-payments/list-an-agents-x402-spend-mandates-beta"},{"title":"Create an x402 spend mandate (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402/mandates","href":"/api-reference/agentic-payments/create-an-x402-spend-mandate-beta"},{"title":"Cancel one scheduled payment (BETA)","description":"> **Beta** — early access.\n\nFinalizes a single still-scheduled payment as cancelled. No signature is required - schedule rows are bookkeeping, not authorization (they are created by a plain API-key call); the signed grant is the MANDATE, which this does not touch. New payments can be instructed under the same mandate at any time. Executed, failed, and already-cancelled rows are not cancellable; a cancel racing the cron at the exact fire moment loses cleanly (the status guard never overwrites an executed payment).\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /scheduled-payments/{scheduled_payment_id}/cancel","href":"/api-reference/agentic-payments/cancel-one-scheduled-payment-beta"},{"title":"Sign an x402 payment authorization (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402/signatures","href":"/api-reference/agentic-payments/sign-an-x402-payment-authorization-beta"},{"title":"Cancel an x402 spend mandate (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /payment-agents/{payment_agent_id}/x402/mandates/{mandate_id}/cancel","href":"/api-reference/agentic-payments/cancel-an-x402-spend-mandate-beta"}]},{"group":"Mandates","pages":[{"title":"List the calling client's mandates (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /mandates","href":"/api-reference/mandates/list-the-calling-clients-mandates-beta"},{"title":"Create a mandate directly (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /mandates","href":"/api-reference/mandates/create-a-mandate-directly-beta"},{"title":"List a mandate's versions (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /mandates/{mandate_id}/versions","href":"/api-reference/mandates/list-a-mandates-versions-beta"},{"title":"Get a mandate's remaining budget (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /mandates/{mandate_id}/budget","href":"/api-reference/mandates/get-a-mandates-remaining-budget-beta"},{"title":"Get a mandate (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /mandates/{mandate_id}","href":"/api-reference/mandates/get-a-mandate-beta"},{"title":"Amend a mandate — append a new version (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /mandates/{mandate_id}/amend","href":"/api-reference/mandates/amend-a-mandate-—-append-a-new-version-beta"},{"title":"Cancel a mandate (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /mandates/{mandate_id}/cancel","href":"/api-reference/mandates/cancel-a-mandate-beta"},{"title":"Approve a mandate (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /mandates/{mandate_id}/approve","href":"/api-reference/mandates/approve-a-mandate-beta"}]},{"group":"Legal","pages":[{"title":"Get a legal document","deprecated":null,"version":null,"openapi":"/openapi.yaml get /legal/documents/{document_key}","href":"/api-reference/legal/get-a-legal-document"},{"title":"List current legal documents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /legal/documents","href":"/api-reference/legal/list-current-legal-documents"}]},{"group":"Insights","pages":[{"title":"Get the customer's account insight report (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /customers/{customer_id}/insights","href":"/api-reference/insights/get-the-customers-account-insight-report-beta"},{"title":"Get the client-level portfolio insight report (BETA)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /insights","href":"/api-reference/insights/get-the-client-level-portfolio-insight-report-beta"}]},{"group":"Account Verifications","pages":[{"title":"List account verification micro-deposits","deprecated":null,"version":null,"openapi":"/openapi.yaml get /account-verifications","href":"/api-reference/account-verifications/list-account-verification-micro-deposits"}]},{"group":"Payouts","pages":[{"title":"Get your developer fee statement","deprecated":null,"version":null,"openapi":"/openapi.yaml get /developer-fees/statement","href":"/api-reference/payouts/get-your-developer-fee-statement"},{"title":"Get your fee payout destination","deprecated":null,"version":null,"openapi":"/openapi.yaml get /fee-payout-destination","href":"/api-reference/payouts/get-your-fee-payout-destination"},{"title":"Register or replace your fee payout destination","deprecated":null,"version":null,"openapi":"/openapi.yaml put /fee-payout-destination","href":"/api-reference/payouts/register-or-replace-your-fee-payout-destination"},{"title":"Remove your fee payout destination","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /fee-payout-destination","href":"/api-reference/payouts/remove-your-fee-payout-destination"}]}]}]},"basePath":"","title":"Create an x402 spend mandate (BETA) - Dakota","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}