Per-authorization bounds for delegated payment authority. This is not
an aggregate spending budget. The containing delegation supplies the
mandate expiry through validUntil.
Show child attributes
Response
Returns challenge ID, delegation ID, and expiry; the action-bound code is sent to the person.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ambient","description":"Build and participate in deterministic markets through HTTP and MCP.","colors":{"primary":"#004D3E","light":"#004D3E","dark":"#7DE0B0"},"favicon":"https://mintcdn.com/ambient-e0cf5f67/7hOa2BO-ut1FqK_l/favicon.svg?fit=max\u0026auto=format\u0026n=7hOa2BO-ut1FqK_l\u0026q=85\u0026s=0969d2e14144ed21f2fe134ae3db7f2d","seo":{"metatags":{"canonical":"https://docs.ambient.market"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ambient-e0cf5f67","hasAudioNarration":false,"actualSubdomain":"ambient-e0cf5f67","customDomains":["docs.ambient.market"],"gitSource":{"type":"github","owner":"ambient-market","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6abeb498cdea67f4a8a3dbea","collectionId":"1610192d-19f3-477b-a364-b2240fdb727b","liveDeploymentHistoryId":"6abeb498cdea67f4a8a3dbea","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6abeb498cdea67f4a8a3dbea","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Reference","count":45},{"language":"default","tag":"HTTP endpoints","count":43},{"language":"default","tag":"Integrate","count":12},{"language":"default","tag":"Participation","count":9},{"language":"default","tag":"Markets","count":7},{"language":"default","tag":"Signup","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Market mechanisms","count":5},{"language":"default","tag":"Administration","count":5},{"language":"default","tag":"System","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"preview.css","content":"#navbar .nav-logo:not(img){display:inline-flex;align-items:center;gap:12px}#navbar .nav-logo:not(img)::after{content:\"Developer preview\";display:inline-block;padding:5px 9px;border-radius:2px;background:#7de0b0;color:#071d17;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;font-weight:600;line-height:1.4;letter-spacing:normal;white-space:nowrap}@media (max-width:1023px){#navbar .nav-logo:not(img){gap:8px;font-size:20px;line-height:1.2}#navbar .nav-logo:not(img)::after{padding:3px 7px;background:0 0;border:1px solid #a8c8bc;color:#004d3e;font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;font-weight:500}.dark #navbar .nav-logo:not(img)::after{border-color:#365d4e;color:#7de0b0}}"}],"page":{"pagePath":"api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority","slug":"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority","pageMetadata":{"title":"Ask a person to approve this agent's bounded authority","description":null,"deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-requests","href":"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority","autogeneratedByOpenApi":true},"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":"Ask a person to approve this agent's bounded authority","description":null,"deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-requests","href":"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Signup"],"operationId":"requestEmailDelegation","summary":"Ask a person to approve this agent's bounded authority","requestBody":"a55850ba-4bd3-4fb5-8164-3744fba992ce","responses":{"202":"0abd5eb6-5c18-44c2-b00a-a0586910e9f7","401":"6c3b82fc-aa8c-48f3-a981-6d7864cb0f1f","429":"62e7332a-78ed-4a20-abec-4bb1a76deefb"},"method":"post","type":"path","servers":["ccaf9552-2a2e-4df0-9e42-c55c270d5a04"],"security":["35dd24b1-7284-4733-9611-2e5506975052","cf6e24dd-c984-41ea-b27c-43d03503dec6"],"path":"/v1/signup/delegation-requests","baseUrlOptions":["https://{host}"],"title":"Ask a person to approve this agent's bounded authority","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["email","scopes","validUntil"],"properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"scopes":{"type":"array","items":{"type":"string","enum":["market:create","market:publish","market:cancel","market:claim","market:bid","market:lottery_enter","market:offer_submit","market:offer_select","commitment:confirm","commitment:decline","commitment:refund","credential:issue","payment:authorize","payment:register_payee_rail"],"uniqueKey":"scopes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"scopes","typeLabel":"enum\u003cstring>[]"},"validUntil":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"validUntil","typeLabel":"string\u003cdate-time>"},"paymentMandate":{"type":"object","additionalProperties":false,"required":["railId","currency","maxAmountMinor"],"description":"Per-authorization bounds for delegated payment authority. This is not\nan aggregate spending budget. The containing delegation supplies the\nmandate expiry through validUntil.\n","properties":{"railId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"paymentMandate.railId","typeLabel":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"paymentMandate.currency","typeLabel":"string"},"maxAmountMinor":{"type":"integer","format":"int64","minimum":1,"isRequired":true,"uniqueKey":"paymentMandate.maxAmountMinor","typeLabel":"integer\u003cint64>"},"payeePrincipalId":{"type":"string","minLength":1,"description":"Principal represented by the authenticated actor.","uniqueKey":"paymentMandate.payeePrincipalId","typeLabel":"string"},"marketId":{"type":"string","minLength":1,"uniqueKey":"paymentMandate.marketId","typeLabel":"string"}},"uniqueKey":"paymentMandate","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"jsmith@example.com","scopes":[],"validUntil":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0abd5eb6-5c18-44c2-b00a-a0586910e9f7":{"description":"Returns challenge ID, delegation ID, and expiry; the action-bound code is sent to the person.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6c3b82fc-aa8c-48f3-a981-6d7864cb0f1f":{"description":"Request authentication failed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","identity_conflict","identity_not_found","invalid_credential","credential_conflict","signing_key_mismatch","delegation_not_found","delegation_conflict","delegation_inactive","not_found","method_not_allowed","idempotency_conflict","concurrent_update","internal_error","invalid_command","authority_reference_required","unknown_mechanism","invalid_mechanism_config","market_not_found","commitment_not_found","principal_not_authorized","version_conflict","invalid_market_transition","invalid_commitment_transition","actor_not_authorized","capacity_exhausted","invalid_payment_authorization","payment_authority_required","payment_mandate_exceeded","payment_rail_unavailable","payment_rail_unsupported"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. Clients should branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthenticated","message":"request authentication failed"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthenticated","message":"request authentication failed"}}}},"exampleType":"examples"}},"exampleType":"examples"},"62e7332a-78ed-4a20-abec-4bb1a76deefb":{"description":"Email challenge rate limit reached.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"35dd24b1-7284-4733-9611-2e5506975052":{"AmbientActor":{"type":"apiKey","in":"header","name":"X-Ambient-Actor","description":"Provisioned actor identifier.","scopes":[]},"AmbientTimestamp":{"type":"apiKey","in":"header","name":"X-Ambient-Timestamp","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","scopes":[]},"AmbientSignature":{"type":"apiKey","in":"header","name":"Authorization","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","scopes":[]}},"cf6e24dd-c984-41ea-b27c-43d03503dec6":{"AmbientBearer":{"type":"http","scheme":"bearer","description":"Short-lived opaque token issued after Ed25519 actor-key proof.","scopes":[]}}},"servers":{"ccaf9552-2a2e-4df0-9e42-c55c270d5a04":{"url":"https://{host}","description":"Hosted Ambient environment","variables":{"host":{"default":"api.ambient.market","description":"Canonical Ambient production API host."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Ambient-Actor","description":"Provisioned actor identifier.","scopes":[]},"schema":{"title":"X-Ambient-Actor","type":"string","description":"Provisioned actor identifier.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientActor","name":"X-Ambient-Actor"},{"scheme":{"type":"apiKey","in":"header","name":"X-Ambient-Timestamp","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","scopes":[]},"schema":{"title":"X-Ambient-Timestamp","type":"string","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientTimestamp","name":"X-Ambient-Timestamp"},{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientSignature","name":"Authorization"}],"title":"AmbientActor \u0026 AmbientTimestamp \u0026 AmbientSignature"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Short-lived opaque token issued after Ed25519 actor-key proof.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Short-lived opaque token issued after Ed25519 actor-key proof.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AmbientBearer","name":"Authorization"}],"title":"AmbientBearer"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"ambient-e0cf5f67","siteName":"Ambient","title":"Ask a person to approve this agent's bounded authority - Ambient","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T19:29:59.815Z","originalFileLocation":"api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority.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=\"system\"}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=\"application-name\" content=\"Ambient\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ask a person to approve this agent\u0026#x27;s bounded authority - Ambient\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ambient\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ambient-e0cf5f67.mintlify.app/_mintlify/api/og/v2?division=Signup\u0026amp;title=Ask+a+person+to+approve+this+agent%27s+bounded+authority\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=f1dab2ab5d221ee83705d0c00cf7b111d30e692cd269dbd565771bdd81feb544\">\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=\"Ask a person to approve this agent\u0026#x27;s bounded authority - Ambient\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ambient-e0cf5f67.mintlify.app/_mintlify/api/og/v2?division=Signup\u0026amp;title=Ask+a+person+to+approve+this+agent%27s+bounded+authority\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=f1dab2ab5d221ee83705d0c00cf7b111d30e692cd269dbd565771bdd81feb544\">\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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ambient\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#004D3E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ambient.market/#organization\",\"name\":\"Ambient\",\"url\":\"https://docs.ambient.market\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ambient.market#website\",\"name\":\"Ambient\",\"url\":\"https://docs.ambient.market\",\"publisher\":{\"@id\":\"https://docs.ambient.market/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority#webpage\",\"url\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority\",\"name\":\"Ask a person to approve this agent's bounded authority\",\"dateModified\":\"2026-10-01T19:29:59.815Z\",\"isPartOf\":{\"@id\":\"https://docs.ambient.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.ambient.market/http-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"HTTP endpoints\",\"item\":\"https://docs.ambient.market/api-reference/system/check-process-liveness\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Signup\",\"item\":\"https://docs.ambient.market/api-reference/signup/start-agent-self-registration-with-a-new-ed25519-key\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Ask a person to approve this agent's bounded authority\",\"item\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority#apireference\",\"headline\":\"Ask a person to approve this agent's bounded authority\",\"name\":\"Ask a person to approve this agent's bounded authority\",\"url\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ambient.market/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority#webpage\"},\"dateModified\":\"2026-10-01T19:29:59.815Z\",\"publisher\":{\"@id\":\"https://docs.ambient.market/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ambient.market#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ambient\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ambient","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Ambient platform","href":"/overview"},{"title":"Run your first market","href":"/quickstart"},{"title":"Resources for agents","href":"/agent-resources"},{"title":"Connect over MCP","href":"/integrate/mcp"},{"title":"Environments and testing","href":"/integrate/environments"}]},{"group":"Integrate","pages":[{"title":"Choose an onboarding path","href":"/integrate/onboarding"},{"title":"OAuth connections","href":"/oauth-connections"},{"title":"Market recipes","href":"/recipes"},{"title":"Errors and retries","href":"/errors-and-retries"},{"title":"Creator onboarding","href":"/seller-onboarding"},{"title":"Participant onboarding","href":"/buyer-onboarding"},{"group":"Market mechanisms","pages":[{"title":"Market mechanisms","href":"/mechanisms"},{"title":"Direct claim","href":"/direct-claim"},{"title":"Sealed auction","href":"/sealed-auction"},{"title":"Request for offers","href":"/request-for-offers"},{"title":"Lottery","href":"/lottery"}]},{"title":"Records and history","href":"/records"}]},{"group":"Core concepts","pages":[{"title":"Core concepts","href":"/concepts"},{"title":"Authentication and authority","href":"/authentication"}]},{"group":"Reference","pages":[{"title":"HTTP API overview","href":"/http-api"},{"group":"HTTP endpoints","pages":[{"group":"System","pages":[{"title":"Check process liveness","deprecated":null,"version":null,"openapi":"/openapi.yaml get /livez","href":"/api-reference/system/check-process-liveness"},{"title":"Check service readiness","deprecated":null,"version":null,"openapi":"/openapi.yaml get /readyz","href":"/api-reference/system/check-service-readiness"},{"title":"Check service readiness (compatibility alias)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /healthz","href":"/api-reference/system/check-service-readiness-compatibility-alias"},{"title":"Check worker and durable-queue health","deprecated":null,"version":null,"openapi":"/openapi.yaml get /ops/healthz","href":"/api-reference/system/check-worker-and-durable-queue-health"},{"title":"Scrape bounded application metrics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /ops/metrics","href":"/api-reference/system/scrape-bounded-application-metrics"}]},{"group":"Authentication","pages":[{"title":"Request an actor-key challenge","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/auth/challenges","href":"/api-reference/authentication/request-an-actor-key-challenge"},{"title":"Exchange an Ed25519 proof for a bearer token","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/auth/tokens","href":"/api-reference/authentication/exchange-an-ed25519-proof-for-a-bearer-token"}]},{"group":"Signup","pages":[{"title":"Start agent self-registration with a new Ed25519 key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/agent-challenges","href":"/api-reference/signup/start-agent-self-registration-with-a-new-ed25519-key"},{"title":"Prove key possession and create a self-representing identity","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/agents","href":"/api-reference/signup/prove-key-possession-and-create-a-self-representing-identity"},{"title":"Send a human-only signup or login code","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/email-challenges","href":"/api-reference/signup/send-a-human-only-signup-or-login-code"},{"title":"Exchange a login-purpose code for a human bearer token","description":null,"deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/email-tokens","href":"/api-reference/signup/exchange-a-login-purpose-code-for-a-human-bearer-token"},{"title":"Ask a person to approve this agent's bounded authority","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-requests","href":"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority"},{"title":"Exchange the person's delegation code for the requested grant","description":null,"deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-approvals","href":"/api-reference/signup/exchange-the-persons-delegation-code-for-the-requested-grant"}]},{"group":"Administration","pages":[{"title":"Provision a principal, actor, and first public key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/identities","href":"/api-reference/administration/provision-a-principal-actor-and-first-public-key"},{"title":"Issue an Ed25519-signed Ambient credential","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/credentials","href":"/api-reference/administration/issue-an-ed25519-signed-ambient-credential"},{"title":"Read authoritative credential status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/admin/credentials/{credentialId}","href":"/api-reference/administration/read-authoritative-credential-status"},{"title":"Revoke an Ambient credential","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/credentials/{credentialId}/revoke","href":"/api-reference/administration/revoke-an-ambient-credential"},{"title":"Register a payee rail through the bootstrap operator","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/payee-rails","href":"/api-reference/administration/register-a-payee-rail-through-the-bootstrap-operator"}]},{"group":"Delegations","pages":[{"title":"Grant bounded authority to an actor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/delegations","href":"/api-reference/delegations/grant-bounded-authority-to-an-actor"},{"title":"Revoke a delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/delegations/{delegationId}/revoke","href":"/api-reference/delegations/revoke-a-delegation"}]},{"group":"Payments","pages":[{"title":"Self-service payee registration (new bindings temporarily blocked)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payee-rails","href":"/api-reference/payments/self-service-payee-registration-new-bindings-temporarily-blocked"},{"title":"Queue a payment authorization","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payment-authorizations","href":"/api-reference/payments/queue-a-payment-authorization"},{"title":"Read an actor-scoped payment operation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/payment-operations/{commandId}","href":"/api-reference/payments/read-an-actor-scoped-payment-operation"}]},{"group":"Markets","pages":[{"title":"Discover published markets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets","href":"/api-reference/markets/discover-published-markets"},{"title":"Create a market draft","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets","href":"/api-reference/markets/create-a-market-draft"},{"title":"Publish a market draft","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/publish","href":"/api-reference/markets/publish-a-market-draft"},{"title":"Cancel a market before participation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/cancel","href":"/api-reference/markets/cancel-a-market-before-participation"},{"title":"Get a published market","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}","href":"/api-reference/markets/get-a-published-market"},{"title":"Get public market activity","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/activity","href":"/api-reference/markets/get-public-market-activity"},{"title":"Get your outcome in a market","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/my-outcome","href":"/api-reference/markets/get-your-outcome-in-a-market"}]},{"group":"Participation","pages":[{"title":"Submit a direct claim","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/direct-claims","href":"/api-reference/participation/submit-a-direct-claim"},{"title":"Submit a sealed bid","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/sealed-bids","href":"/api-reference/participation/submit-a-sealed-bid"},{"title":"Enter an unfunded lottery before its cutoff","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/lottery-entries","href":"/api-reference/participation/enter-an-unfunded-lottery-before-its-cutoff"},{"title":"Withdraw an owned active entry before entries close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/lottery-withdrawals","href":"/api-reference/participation/withdraw-an-owned-active-entry-before-entries-close"},{"title":"Read selected candidate evidence and review history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/lottery-review","href":"/api-reference/participation/read-selected-candidate-evidence-and-review-history"},{"title":"Read offers visible to the currently authorized principal","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/offers","href":"/api-reference/participation/read-offers-visible-to-the-currently-authorized-principal"},{"title":"Submit a private offer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offers","href":"/api-reference/participation/submit-a-private-offer"},{"title":"Withdraw your own active offer before close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offer-withdrawals","href":"/api-reference/participation/withdraw-your-own-active-offer-before-close"},{"title":"Select offers as the requester after close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offer-selections","href":"/api-reference/participation/select-offers-as-the-requester-after-close"}]},{"group":"Commitments","pages":[{"title":"Confirm a commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/confirm","href":"/api-reference/commitments/confirm-a-commitment"},{"title":"Decline a commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/decline","href":"/api-reference/commitments/decline-a-commitment"},{"title":"Refund a settled commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/refund","href":"/api-reference/commitments/refund-a-settled-commitment"}]},{"group":"Records","pages":[{"title":"Get a market record","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/record","href":"/api-reference/records/get-a-market-record"}]}]},{"title":"MCP tools","href":"/mcp-tools"}]},{"group":"Experimental","pages":[{"title":"Payments","href":"/payments"}]}]},"basePath":"","title":"Ask a person to approve this agent's bounded authority - Ambient","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}