Queues asynchronous authorization through a configured rail. A
self-representing principal may authorize directly. A different actor
must cite an active delegation with payment:authorize scope and a
mandate covering the rail, currency, per-authorization amount, optional
payee/market restrictions, and requested expiry.
{"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/payments/queue-a-payment-authorization","slug":"/api-reference/payments/queue-a-payment-authorization","pageMetadata":{"title":"Queue a payment authorization","description":"Queues asynchronous authorization through a configured rail. A\nself-representing principal may authorize directly. A different actor\nmust cite an active delegation with `payment:authorize` scope and a\nmandate covering the rail, currency, per-authorization amount, optional\npayee/market restrictions, and requested expiry.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payment-authorizations","href":"/api-reference/payments/queue-a-payment-authorization","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Queues asynchronous authorization through a configured rail. A\\nself-representing principal may authorize directly. A different actor\\nmust cite an active delegation with \", _jsx(_components.code, {\n children: \"payment:authorize\"\n }), \" scope and a\\nmandate covering the rail, currency, per-authorization amount, optional\\npayee/market restrictions, and requested expiry.\"]\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":"Queue a payment authorization","description":"Queues asynchronous authorization through a configured rail. A\nself-representing principal may authorize directly. A different actor\nmust cite an active delegation with `payment:authorize` scope and a\nmandate covering the rail, currency, per-authorization amount, optional\npayee/market restrictions, and requested expiry.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payment-authorizations","href":"/api-reference/payments/queue-a-payment-authorization","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Payments"],"operationId":"authorizePayment","summary":"Queue a payment authorization","description":"Queues asynchronous authorization through a configured rail. A\nself-representing principal may authorize directly. A different actor\nmust cite an active delegation with `payment:authorize` scope and a\nmandate covering the rail, currency, per-authorization amount, optional\npayee/market restrictions, and requested expiry.\n","requestBody":"751cc11f-f8e8-4060-afaf-18311db3916f","responses":{"202":"ea55d750-6d37-4e40-a50f-5643c0d4b612","400":"aaef0d9b-14c5-4a2e-bb3e-7bb8eb0f6dac","401":"c1efd0ae-073d-4fd6-a78d-bfda454f5ad6","403":"90b7b002-ecc6-4fae-a2af-753daed94b4a","409":"6943a4c7-d83c-40ac-bcba-4481da49900c","422":"5124f152-185d-4ad7-98e0-a75d33906629","500":"25a2a69f-8407-42ca-add8-b9c87f1afc14"},"method":"post","type":"path","servers":["ccaf9552-2a2e-4df0-9e42-c55c270d5a04"],"security":["35dd24b1-7284-4733-9611-2e5506975052","cf6e24dd-c984-41ea-b27c-43d03503dec6"],"path":"/v1/payment-authorizations","baseUrlOptions":["https://{host}"],"title":"Queue a payment authorization","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["commandId","authorizationId","railId","principalId","payeePrincipalId","marketId","amountMinor","currency","expiresAt"],"properties":{"commandId":{"type":"string","minLength":1,"description":"Actor-scoped idempotency key. Retry the identical command with the same value.","isRequired":true,"uniqueKey":"commandId","typeLabel":"string"},"authorizationId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"authorizationId","typeLabel":"string"},"railId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"railId","typeLabel":"string"},"principalId":{"type":"string","minLength":1,"description":"Principal represented by the authenticated actor.","isRequired":true,"uniqueKey":"principalId","typeLabel":"string"},"payeePrincipalId":{"type":"string","minLength":1,"description":"Principal represented by the authenticated actor.","isRequired":true,"uniqueKey":"payeePrincipalId","typeLabel":"string"},"marketId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"marketId","typeLabel":"string"},"amountMinor":{"type":"integer","format":"int64","minimum":1,"isRequired":true,"uniqueKey":"amountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"expiresAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time>"},"authorityRef":{"type":"string","minLength":1,"description":"Required delegation identifier when the actor and principal differ. Omit for self-action.","uniqueKey":"authorityRef","typeLabel":"string"},"paymentCredential":{"type":"string","minLength":1,"writeOnly":true,"description":"Private one-time authorization material required by some rails.","uniqueKey":"paymentCredential","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"commandId":"\u003cstring>","authorizationId":"\u003cstring>","railId":"\u003cstring>","principalId":"\u003cstring>","payeePrincipalId":"\u003cstring>","marketId":"\u003cstring>","amountMinor":2,"currency":"USD","expiresAt":"2023-11-07T05:31:56Z","authorityRef":"\u003cstring>","paymentCredential":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ea55d750-6d37-4e40-a50f-5643c0d4b612":{"description":"Authorization operation queued or an identical command replayed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["commandId","kind","railId","authorizationId","identity","request","status","attempts","nextAttemptAt","occurredAt","recordedAt","updatedAt"],"properties":{"commandId":{"type":"string","minLength":1,"description":"Actor-scoped idempotency key. Retry the identical command with the same value.","isRequired":true,"uniqueKey":"commandId","typeLabel":"string"},"kind":{"type":"string","const":"payment.authorize","isRequired":true,"uniqueKey":"kind","typeLabel":"string"},"railId":{"type":"string","isRequired":true,"uniqueKey":"railId","typeLabel":"string"},"authorizationId":{"type":"string","isRequired":true,"uniqueKey":"authorizationId","typeLabel":"string"},"identity":{"type":"object","additionalProperties":false,"required":["principalId","actorId"],"properties":{"principalId":{"type":"string","minLength":1,"description":"Principal whose rights or obligations are affected.","isRequired":true,"uniqueKey":"identity.principalId","typeLabel":"string"},"actorId":{"type":"string","minLength":1,"description":"Authenticated actor that submitted the command.","isRequired":true,"uniqueKey":"identity.actorId","typeLabel":"string"},"authorityRef":{"type":"string","minLength":1,"description":"Delegation used when actorId and principalId differ.","uniqueKey":"identity.authorityRef","typeLabel":"string"}},"isRequired":true,"uniqueKey":"identity","typeLabel":"object"},"request":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"request","typeLabel":"object"},"status":{"type":"string","enum":["pending","leased","succeeded","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"attempts":{"type":"integer","format":"uint32","isRequired":true,"uniqueKey":"attempts","typeLabel":"integer\u003cuint32>"},"nextAttemptAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"nextAttemptAt","typeLabel":"string\u003cdate-time>"},"occurredAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"occurredAt","typeLabel":"string\u003cdate-time>"},"recordedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"recordedAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"leaseUntil":{"type":"string","format":"date-time","uniqueKey":"leaseUntil","typeLabel":"string\u003cdate-time>"},"lastError":{"type":"string","uniqueKey":"lastError","typeLabel":"string"},"rejectionCode":{"type":"string","uniqueKey":"rejectionCode","typeLabel":"string"},"result":{"type":"object","additionalProperties":false,"required":["id","railId","railReference","payerPrincipalId","payeePrincipalId","marketId","state","authorizedAmountMinor","settledAmountMinor","refundedAmountMinor","currency","authorizationExpiresAt","createdAt","updatedAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"result.id","typeLabel":"string"},"railId":{"type":"string","isRequired":true,"uniqueKey":"result.railId","typeLabel":"string"},"railReference":{"type":"string","isRequired":true,"uniqueKey":"result.railReference","typeLabel":"string"},"payerPrincipalId":{"type":"string","minLength":1,"description":"Principal represented by the authenticated actor.","isRequired":true,"uniqueKey":"result.payerPrincipalId","typeLabel":"string"},"payeePrincipalId":{"type":"string","minLength":1,"description":"Principal represented by the authenticated actor.","isRequired":true,"uniqueKey":"result.payeePrincipalId","typeLabel":"string"},"marketId":{"type":"string","isRequired":true,"uniqueKey":"result.marketId","typeLabel":"string"},"state":{"type":"string","enum":["authorized","settled","canceled","refunded"],"isRequired":true,"uniqueKey":"result.state","typeLabel":"enum\u003cstring>"},"authorizedAmountMinor":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"result.authorizedAmountMinor","typeLabel":"integer\u003cint64>"},"settledAmountMinor":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"result.settledAmountMinor","typeLabel":"integer\u003cint64>"},"refundedAmountMinor":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"result.refundedAmountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"result.currency","typeLabel":"string"},"authorizationExpiresAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"result.authorizationExpiresAt","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"result.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"result.updatedAt","typeLabel":"string\u003cdate-time>"},"commitmentId":{"type":"string","uniqueKey":"result.commitmentId","typeLabel":"string"}},"uniqueKey":"result","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"commandId":"\u003cstring>","kind":"payment.authorize","railId":"\u003cstring>","authorizationId":"\u003cstring>","identity":{"principalId":"\u003cstring>","actorId":"\u003cstring>","authorityRef":"\u003cstring>"},"request":{},"status":"pending","attempts":123,"nextAttemptAt":"2023-11-07T05:31:56Z","occurredAt":"2023-11-07T05:31:56Z","recordedAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","leaseUntil":"2023-11-07T05:31:56Z","lastError":"\u003cstring>","rejectionCode":"\u003cstring>","result":{"id":"\u003cstring>","railId":"\u003cstring>","railReference":"\u003cstring>","payerPrincipalId":"\u003cstring>","payeePrincipalId":"\u003cstring>","marketId":"\u003cstring>","state":"authorized","authorizedAmountMinor":123,"settledAmountMinor":123,"refundedAmountMinor":123,"currency":"USD","authorizationExpiresAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","commitmentId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"aaef0d9b-14c5-4a2e-bb3e-7bb8eb0f6dac":{"description":"The JSON or command fields are invalid.","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"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c1efd0ae-073d-4fd6-a78d-bfda454f5ad6":{"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"},"90b7b002-ecc6-4fae-a2af-753daed94b4a":{"description":"The actor or principal is not authorized for this action.","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"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6943a4c7-d83c-40ac-bcba-4481da49900c":{"description":"The command conflicts with current state, version, capacity, or idempotency history.","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"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5124f152-185d-4ad7-98e0-a75d33906629":{"description":"The mechanism preset is unknown or its configuration is invalid.","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"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"25a2a69f-8407-42ca-add8-b9c87f1afc14":{"description":"The command could not be completed because of an internal failure.","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"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"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":"Queue a payment authorization - Ambient","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T17:43:17.793Z","originalFileLocation":"api-reference/payments/queue-a-payment-authorization.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=\"description\" content=\"Queues asynchronous authorization through a configured rail. A self-representing principal may authorize directly. A different actor must cite an active delegation with payment:authorize scope and a mandate covering the rail, currency, per-authorization amount, optional payee/market restrictions, and requested expiry.\">\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=\"Queue a payment authorization - Ambient\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queues asynchronous authorization through a configured rail. A self-representing principal may authorize directly. A different actor must cite an active delegation with payment:authorize scope and a mandate covering the rail, currency, per-authorization amount, optional payee/market restrictions, and requested expiry.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ambient\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization\">\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=Payments\u0026amp;title=Queue+a+payment+authorization\u0026amp;description=Queues+asynchronous+authorization+through+a+configured+rail.+A%0Aself-representing+principal+may+authorize+directly.+A+different+actor%0Amust+cite+an+active+delegat\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=8652ef64f92dea6eff3ca2fa0e2d2e1918b63e10cf9eaf9ad78678faf8706e7c\">\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=\"Queue a payment authorization - Ambient\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queues asynchronous authorization through a configured rail. A self-representing principal may authorize directly. A different actor must cite an active delegation with payment:authorize scope and a mandate covering the rail, currency, per-authorization amount, optional payee/market restrictions, and requested expiry.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ambient-e0cf5f67.mintlify.app/_mintlify/api/og/v2?division=Payments\u0026amp;title=Queue+a+payment+authorization\u0026amp;description=Queues+asynchronous+authorization+through+a+configured+rail.+A%0Aself-representing+principal+may+authorize+directly.+A+different+actor%0Amust+cite+an+active+delegat\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=8652ef64f92dea6eff3ca2fa0e2d2e1918b63e10cf9eaf9ad78678faf8706e7c\">\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/payments/queue-a-payment-authorization\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payments/queue-a-payment-authorization.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/payments/queue-a-payment-authorization#webpage\",\"url\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization\",\"name\":\"Queue a payment authorization\",\"description\":\"Queues asynchronous authorization through a configured rail. A self-representing principal may authorize directly. A different actor must cite an active delegation with payment:authorize scope and a mandate covering the rail, currency, per-authorization amount, optional payee/market restrictions, and requested expiry.\",\"dateModified\":\"2026-09-30T17:43:17.793Z\",\"isPartOf\":{\"@id\":\"https://docs.ambient.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization#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\":\"Payments\",\"item\":\"https://docs.ambient.market/api-reference/payments/self-service-payee-registration-new-bindings-temporarily-blocked\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Queue a payment authorization\",\"item\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization#apireference\",\"headline\":\"Queue a payment authorization\",\"name\":\"Queue a payment authorization\",\"description\":\"Queues asynchronous authorization through a configured rail. A self-representing principal may authorize directly. A different actor must cite an active delegation with payment:authorize scope and a mandate covering the rail, currency, per-authorization amount, optional payee/market restrictions, and requested expiry.\",\"url\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ambient.market/api-reference/payments/queue-a-payment-authorization#webpage\"},\"dateModified\":\"2026-09-30T17:43:17.793Z\",\"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","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","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)","description":"New self-service bindings are temporarily rejected with\n`payee_rail_onboarding_required` until principal-bound Connect\nonboarding can establish account ownership. Existing identical\ncommands may replay. The private adapter reference is never returned.\n","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","description":"Returns the safe status projection for a payment command queued by the\nauthenticated actor. Operations owned by another actor are\nindistinguishable from missing operations. Raw requests and results,\nprovider errors, rail references, lease state, and journal entries are\nnot disclosed. A succeeded operation's authorizationState is read from\nthe independently verified authorization record.\n","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":"Queue a payment authorization - 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"]}