find-and-add + create a Stella-hosted checkout the customer
taps to pay.
Returns {checkout_url, requires_confirmation: true}. Stella
NEVER auto-pays — the customer is always the final approver.
Phase 6 decision C2.
Budget consumption happens at ORDER creation in
CheckoutFinalizer.finalize (decision A5), NOT here. The
pre-flight 402 catches obvious cap breaches early but doesn’t
reserve budget — this means an agent COULD create N checkouts
that cumulatively exceed the cap, but only the ones the
customer actually pays for consume budget.
Agent → Stella: POST /api/agent/intent/find-and-buy.
Same semantics as find-and-add, plus a Stella-hosted checkout
that the customer taps to pay. Stella NEVER charges the card
on the agent's behalf — the customer is always the final
approver. Phase 6 decision C2.
Shipping address dict. Must contain at least first_name, last_name, address1, city, country. Phase 6-C2 v1 doesn't validate the schema strictly — it passes through to CheckoutService.create_checkout which stores it as-is on checkouts.shipping_address. Agents should pass what their LLM-tool-call schema produces.
Email for the order confirmation. Defaults to the agent's linked customer.email when omitted.
Response
Successful Response
Response shape for POST /api/agent/intent/find-and-buy.
requires_confirmation is always True — the agent MUST surface
checkout_url to the customer for final approval. Auto-paying
on the agent's behalf is explicitly out of scope (Phase 6
decision C2; revisit if regulators ever say it's safe).
summary_for_llm is the single-paragraph natural-language summary
an LLM can read to decide if this matches a user's intent. The
structured fields below it are for follow-up calls (cart adds,
detail renders) and reasoning attribution. Keep this shape FLAT —
LLMs handle nesting poorly.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stella","description":"Agentic-ready commerce backend for headless storefronts.","colors":{"primary":"#0EA5E9","light":"#38BDF8","dark":"#0369A1"},"api":{"playground":{"display":"interactive"}},"footer":{"socials":{"github":"https://github.com/Zunkireelabs/agenticom"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stella-a663a7ad","hasAudioNarration":false,"actualSubdomain":"stella-a663a7ad","customDomains":["docs.stella-commerce.com"],"gitSource":{"type":"github","owner":"zunkireelabs","repo":"agenticom","deployBranch":"stage","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21de0129c7042dd5f5ffbd","collectionId":"f1e23acc-bbad-45af-b5c7-930d802e34d5","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21de0129c7042dd5f5ffbd:success","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":173},{"language":"default","tag":"Dashboard","count":97},{"language":"default","tag":"Storefront","count":47},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Sync v1","count":9},{"language":"default","tag":"Agent","count":8},{"language":"default","tag":"Sync","count":7},{"language":"default","tag":"Authentication","count":4},{"language":"default","tag":"Concepts","count":3},{"language":"default","tag":"Get Started","count":2}]},"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":[],"page":{"pagePath":"api-reference/agent/post-intent-find-and-buy","slug":"/api-reference/agent/post-intent-find-and-buy","pageMetadata":{"title":"Post Intent Find And Buy","description":"find-and-add + create a Stella-hosted checkout the customer\ntaps to pay.\n\nReturns `{checkout_url, requires_confirmation: true}`. Stella\nNEVER auto-pays — the customer is always the final approver.\nPhase 6 decision C2.\n\nBudget consumption happens at ORDER creation in\n`CheckoutFinalizer.finalize` (decision A5), NOT here. The\npre-flight 402 catches obvious cap breaches early but doesn't\nreserve budget — this means an agent COULD create N checkouts\nthat cumulatively exceed the cap, but only the ones the\ncustomer actually pays for consume budget.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/intent/find-and-buy","href":"/api-reference/agent/post-intent-find-and-buy","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"find-and-add + create a Stella-hosted checkout the customer\\ntaps to pay.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns \", _jsx(_components.code, {\n children: \"{checkout_url, requires_confirmation: true}\"\n }), \". Stella\\nNEVER auto-pays — the customer is always the final approver.\\nPhase 6 decision C2.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Budget consumption happens at ORDER creation in\\n\", _jsx(_components.code, {\n children: \"CheckoutFinalizer.finalize\"\n }), \" (decision A5), NOT here. The\\npre-flight 402 catches obvious cap breaches early but doesn’t\\nreserve budget — this means an agent COULD create N checkouts\\nthat cumulatively exceed the cap, but only the ones the\\ncustomer actually pays for consume budget.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Post Intent Find And Buy","description":"find-and-add + create a Stella-hosted checkout the customer\ntaps to pay.\n\nReturns `{checkout_url, requires_confirmation: true}`. Stella\nNEVER auto-pays — the customer is always the final approver.\nPhase 6 decision C2.\n\nBudget consumption happens at ORDER creation in\n`CheckoutFinalizer.finalize` (decision A5), NOT here. The\npre-flight 402 catches obvious cap breaches early but doesn't\nreserve budget — this means an agent COULD create N checkouts\nthat cumulatively exceed the cap, but only the ones the\ncustomer actually pays for consume budget.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/intent/find-and-buy","href":"/api-reference/agent/post-intent-find-and-buy","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agent","Agent Intent"],"summary":"Post Intent Find And Buy","description":"find-and-add + create a Stella-hosted checkout the customer\ntaps to pay.\n\nReturns `{checkout_url, requires_confirmation: true}`. Stella\nNEVER auto-pays — the customer is always the final approver.\nPhase 6 decision C2.\n\nBudget consumption happens at ORDER creation in\n`CheckoutFinalizer.finalize` (decision A5), NOT here. The\npre-flight 402 catches obvious cap breaches early but doesn't\nreserve budget — this means an agent COULD create N checkouts\nthat cumulatively exceed the cap, but only the ones the\ncustomer actually pays for consume budget.","operationId":"post_intent_find_and_buy_api_agent_intent_find_and_buy_post","parameters":["85b1f444-fbe8-45c1-92c4-98eff6a796fe","519af354-efb0-4eae-8a11-1328154baae0"],"requestBody":"f02f746f-5a03-46b7-b10a-ba1cb812ea47","responses":{"200":"ad28d6d6-22dc-4bb2-8cec-0899c55757fc","422":"eb74c71d-e52b-43d9-9bdb-16ea633c8a01"},"method":"post","type":"path","servers":[],"security":[],"path":"/api/agent/intent/find-and-buy","baseUrlOptions":[],"title":"Post Intent Find And Buy","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"85b1f444-fbe8-45c1-92c4-98eff6a796fe":{"name":"X-Site-ID","in":"header","required":true,"schema":{"type":"string","title":"X-Site-Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"519af354-efb0-4eae-8a11-1328154baae0":{"name":"authorization","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Authorization","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"type":"string","maxLength":512,"minLength":1,"title":"Query","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"shipping_address":{"additionalProperties":true,"type":"object","title":"Shipping Address","description":"Shipping address dict. Must contain at least `first_name`, `last_name`, `address1`, `city`, `country`. Phase 6-C2 v1 doesn't validate the schema strictly — it passes through to `CheckoutService.create_checkout` which stores it as-is on `checkouts.shipping_address`. Agents should pass what their LLM-tool-call schema produces.","isRequired":true,"uniqueKey":"shipping_address","typeLabel":"Shipping Address · object"},"quantity":{"type":"integer","maximum":10,"minimum":1,"title":"Quantity","default":1,"uniqueKey":"quantity","typeLabel":"integer"},"max_unit_price_cents":{"oneOf":[{"type":"integer","title":"Max Unit Price Cents","maximum":10000000,"minimum":0,"uniqueKey":"max_unit_price_cents.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Unit Price Cents","uniqueKey":"max_unit_price_cents.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_unit_price_cents","typeLabel":"integer | null"},"email":{"oneOf":[{"type":"string","title":"Email","description":"Email for the order confirmation. Defaults to the agent's linked customer.email when omitted.","uniqueKey":"email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","description":"Email for the order confirmation. Defaults to the agent's linked customer.email when omitted.","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string | null"}},"type":"object","required":["query","shipping_address"],"title":"AgentIntentFindAndBuyBody","description":"Agent → Stella: `POST /api/agent/intent/find-and-buy`.\n\nSame semantics as find-and-add, plus a Stella-hosted checkout\nthat the customer taps to pay. Stella NEVER charges the card\non the agent's behalf — the customer is always the final\napprover. Phase 6 decision C2.","uniqueKey":"","typeLabel":"AgentIntentFindAndBuyBody · object"},"examples":{"Example":{"title":"Example","value":{"query":"\u003cstring>","shipping_address":{},"quantity":1,"max_unit_price_cents":5000000,"email":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ad28d6d6-22dc-4bb2-8cec-0899c55757fc":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"cart":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"cart.id","typeLabel":"string\u003cuuid>"},"currency":{"type":"string","title":"Currency","isRequired":true,"uniqueKey":"cart.currency","typeLabel":"string"},"items":{"items":{"properties":{"variant_id":{"type":"string","format":"uuid","title":"Variant Id","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].variant_id","typeLabel":"string\u003cuuid>"},"product_id":{"type":"string","format":"uuid","title":"Product Id","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].product_id","typeLabel":"string\u003cuuid>"},"product_name":{"type":"string","title":"Product Name","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].product_name","typeLabel":"string"},"quantity":{"type":"integer","title":"Quantity","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].quantity","typeLabel":"integer"},"price_cents":{"type":"integer","title":"Price Cents","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].price_cents","typeLabel":"integer"},"line_total_cents":{"type":"integer","title":"Line Total Cents","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].line_total_cents","typeLabel":"integer"},"variant_name":{"oneOf":[{"type":"string","title":"Variant Name","uniqueKey":"cart.\\items.items.[INDEX].variant_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Variant Name","uniqueKey":"cart.\\items.items.[INDEX].variant_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"cart.\\items.items.[INDEX].variant_name","typeLabel":"string | null"},"sku":{"oneOf":[{"type":"string","title":"Sku","uniqueKey":"cart.\\items.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sku","uniqueKey":"cart.\\items.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"uniqueKey":"cart.\\items.items.[INDEX].sku","typeLabel":"string | null"}},"type":"object","required":["variant_id","product_id","product_name","quantity","price_cents","line_total_cents"],"title":"AgentCartLineItem","description":"LLM-shape cart line. Fields chosen so an agent can render a\nconfirmation message without a follow-up product fetch.","uniqueKey":"cart.\\items.items.[INDEX]","typeLabel":"AgentCartLineItem · object"},"type":"array","title":"Items","isRequired":true,"uniqueKey":"cart.\\items","typeLabel":"AgentCartLineItem · object[]"},"subtotal_cents":{"type":"integer","title":"Subtotal Cents","isRequired":true,"uniqueKey":"cart.subtotal_cents","typeLabel":"integer"},"item_count":{"type":"integer","title":"Item Count","isRequired":true,"uniqueKey":"cart.item_count","typeLabel":"integer"},"summary_for_llm":{"type":"string","title":"Summary For Llm","isRequired":true,"uniqueKey":"cart.summary_for_llm","typeLabel":"string"}},"type":"object","required":["id","currency","items","subtotal_cents","item_count","summary_for_llm"],"title":"AgentCart","description":"LLM-shape cart snapshot. Mirrors the storefront cart but in\ninteger-cents currency and with `summary_for_llm` for the\none-line agent-readable digest.","isRequired":true,"uniqueKey":"cart","typeLabel":"AgentCart · object"},"checkout_id":{"type":"string","format":"uuid","title":"Checkout Id","isRequired":true,"uniqueKey":"checkout_id","typeLabel":"string\u003cuuid>"},"checkout_url":{"type":"string","title":"Checkout Url","isRequired":true,"uniqueKey":"checkout_url","typeLabel":"string"},"summary":{"type":"string","title":"Summary","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"expires_in":{"type":"integer","title":"Expires In","description":"Seconds until the chk_ token in the URL fragment expires. After this, the customer's tap returns a 401 and the agent must re-issue.","isRequired":true,"uniqueKey":"expires_in","typeLabel":"integer"},"total_cents":{"type":"integer","title":"Total Cents","isRequired":true,"uniqueKey":"total_cents","typeLabel":"integer"},"currency":{"type":"string","title":"Currency","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"chosen":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"chosen.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"chosen.name","typeLabel":"string"},"slug":{"oneOf":[{"type":"string","title":"Slug","isRequired":true,"uniqueKey":"chosen.slug.oneOf.0","typeLabel":"string"},{"type":"null","title":"Slug","isRequired":true,"uniqueKey":"chosen.slug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chosen.slug","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","isRequired":true,"uniqueKey":"chosen.description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","isRequired":true,"uniqueKey":"chosen.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chosen.description","typeLabel":"string | null"},"vendor":{"oneOf":[{"type":"string","title":"Vendor","isRequired":true,"uniqueKey":"chosen.vendor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Vendor","isRequired":true,"uniqueKey":"chosen.vendor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chosen.vendor","typeLabel":"string | null"},"product_type":{"oneOf":[{"type":"string","title":"Product Type","isRequired":true,"uniqueKey":"chosen.product_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Product Type","isRequired":true,"uniqueKey":"chosen.product_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chosen.product_type","typeLabel":"string | null"},"tags":{"items":{"type":"string","uniqueKey":"chosen.tags.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Tags","isRequired":true,"uniqueKey":"chosen.tags","typeLabel":"string[]"},"image_url":{"oneOf":[{"type":"string","title":"Image Url","isRequired":true,"uniqueKey":"chosen.image_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Image Url","isRequired":true,"uniqueKey":"chosen.image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"chosen.image_url","typeLabel":"string | null"},"price_min_cents":{"type":"integer","title":"Price Min Cents","isRequired":true,"uniqueKey":"chosen.price_min_cents","typeLabel":"integer"},"price_max_cents":{"type":"integer","title":"Price Max Cents","isRequired":true,"uniqueKey":"chosen.price_max_cents","typeLabel":"integer"},"currency":{"type":"string","title":"Currency","isRequired":true,"uniqueKey":"chosen.currency","typeLabel":"string"},"in_stock":{"type":"boolean","title":"In Stock","isRequired":true,"uniqueKey":"chosen.in_stock","typeLabel":"boolean"},"total_inventory":{"type":"integer","title":"Total Inventory","isRequired":true,"uniqueKey":"chosen.total_inventory","typeLabel":"integer"},"variant_count":{"type":"integer","title":"Variant Count","isRequired":true,"uniqueKey":"chosen.variant_count","typeLabel":"integer"},"variants":{"items":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].title","typeLabel":"string"},"price_cents":{"type":"integer","title":"Price Cents","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].price_cents","typeLabel":"integer"},"options":{"additionalProperties":true,"type":"object","title":"Options","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].options","typeLabel":"Options · object"},"inventory_quantity":{"type":"integer","title":"Inventory Quantity","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].inventory_quantity","typeLabel":"integer"},"in_stock":{"type":"boolean","title":"In Stock","isRequired":true,"uniqueKey":"chosen.variants.items.[INDEX].in_stock","typeLabel":"boolean"},"sku":{"oneOf":[{"type":"string","title":"Sku","uniqueKey":"chosen.variants.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sku","uniqueKey":"chosen.variants.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"uniqueKey":"chosen.variants.items.[INDEX].sku","typeLabel":"string | null"}},"type":"object","required":["id","title","price_cents","options","inventory_quantity","in_stock"],"title":"AgentCatalogVariant","description":"LLM-shape product variant. Inventory snapshot included so the\nLLM doesn't hand the customer a candidate that's out of stock.","uniqueKey":"chosen.variants.items.[INDEX]","typeLabel":"AgentCatalogVariant · object"},"type":"array","title":"Variants","isRequired":true,"uniqueKey":"chosen.variants","typeLabel":"AgentCatalogVariant · object[]"},"summary_for_llm":{"type":"string","title":"Summary For Llm","isRequired":true,"uniqueKey":"chosen.summary_for_llm","typeLabel":"string"}},"type":"object","required":["id","name","slug","description","vendor","product_type","tags","image_url","price_min_cents","price_max_cents","currency","in_stock","total_inventory","variant_count","variants","summary_for_llm"],"title":"AgentCatalogProduct","description":"LLM-shape product.\n\n`summary_for_llm` is the single-paragraph natural-language summary\nan LLM can read to decide if this matches a user's intent. The\nstructured fields below it are for follow-up calls (cart adds,\ndetail renders) and reasoning attribution. Keep this shape FLAT —\nLLMs handle nesting poorly.","isRequired":true,"uniqueKey":"chosen","typeLabel":"AgentCatalogProduct · object"},"chosen_variant_id":{"type":"string","format":"uuid","title":"Chosen Variant Id","isRequired":true,"uniqueKey":"chosen_variant_id","typeLabel":"string\u003cuuid>"},"quantity_added":{"type":"integer","title":"Quantity Added","isRequired":true,"uniqueKey":"quantity_added","typeLabel":"integer"},"match_reasons":{"items":{"type":"string","uniqueKey":"match_reasons.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Match Reasons","isRequired":true,"uniqueKey":"match_reasons","typeLabel":"string[]"},"requires_confirmation":{"type":"boolean","title":"Requires Confirmation","default":true,"uniqueKey":"requires_confirmation","typeLabel":"boolean"}},"type":"object","required":["cart","checkout_id","checkout_url","summary","expires_in","total_cents","currency","chosen","chosen_variant_id","quantity_added","match_reasons"],"title":"AgentIntentFindAndBuyResponse","description":"Response shape for `POST /api/agent/intent/find-and-buy`.\n\n`requires_confirmation` is always True — the agent MUST surface\n`checkout_url` to the customer for final approval. Auto-paying\non the agent's behalf is explicitly out of scope (Phase 6\ndecision C2; revisit if regulators ever say it's safe).","uniqueKey":"","typeLabel":"AgentIntentFindAndBuyResponse · object"},"examples":{"Example":{"title":"Example","value":{"cart":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","currency":"\u003cstring>","items":[{"variant_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","product_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","product_name":"\u003cstring>","quantity":123,"price_cents":123,"line_total_cents":123,"variant_name":"\u003cstring>","sku":"\u003cstring>"}],"subtotal_cents":123,"item_count":123,"summary_for_llm":"\u003cstring>"},"checkout_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","checkout_url":"\u003cstring>","summary":"\u003cstring>","expires_in":123,"total_cents":123,"currency":"\u003cstring>","chosen":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","slug":"\u003cstring>","description":"\u003cstring>","vendor":"\u003cstring>","product_type":"\u003cstring>","tags":["\u003cstring>"],"image_url":"\u003cstring>","price_min_cents":123,"price_max_cents":123,"currency":"\u003cstring>","in_stock":true,"total_inventory":123,"variant_count":123,"variants":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","price_cents":123,"options":{},"inventory_quantity":123,"in_stock":true,"sku":"\u003cstring>"}],"summary_for_llm":"\u003cstring>"},"chosen_variant_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","quantity_added":123,"match_reasons":["\u003cstring>"],"requires_confirmation":true}}},"exampleType":"generated"}},"exampleType":"generated"},"eb74c71d-e52b-43d9-9bdb-16ea633c8a01":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"stella-a663a7ad","siteName":"Stella","title":"Post Intent Find And Buy - Stella","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-21T08:25:36.072Z","originalFileLocation":"api-reference/agent/post-intent-find-and-buy.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=\"find-and-add + create a Stella-hosted checkout the customer taps to pay. Returns {checkout_url, requires_confirmation: true}. Stella NEVER auto-pays — the customer is always the final approver. Phase 6 decision C2. Budget consumption happens at ORDER creation in CheckoutFinalizer.finalize (decision A5), NOT here. The pre-flight 402 catches obvious cap breaches early but doesn\u0026#x27;t reserve budget — this means an agent COULD create N checkouts that cumulatively exceed the cap, but only the ones the customer actually pays for consume budget.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stella\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/stella-a663a7ad/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/stella-a663a7ad/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/stella-a663a7ad/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/stella-a663a7ad/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Post Intent Find And Buy - Stella\">\u003cmeta data-mint-head property=\"og:description\" content=\"find-and-add + create a Stella-hosted checkout the customer taps to pay. Returns {checkout_url, requires_confirmation: true}. Stella NEVER auto-pays — the customer is always the final approver. Phase 6 decision C2. Budget consumption happens at ORDER creation in CheckoutFinalizer.finalize (decision A5), NOT here. The pre-flight 402 catches obvious cap breaches early but doesn\u0026#x27;t reserve budget — this means an agent COULD create N checkouts that cumulatively exceed the cap, but only the ones the customer actually pays for consume budget.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stella\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stella-a663a7ad.mintlify.app/_mintlify/api/og/v2?division=Agent\u0026amp;title=Post+Intent+Find+And+Buy\u0026amp;description=find-and-add+%2B+create+a+Stella-hosted+checkout+the+customer%0Ataps+to+pay.%0A%0AReturns+%60%7Bcheckout_url%2C+requires_confirmation%3A+true%7D%60.+Stella%0ANEVER+auto-pays+%E2%80%94+the+cu\u0026amp;theme=4856e7f14517874ee4dfeeb7\u0026amp;signature=8fe72d0608c0244890cc158fb41381d1d54811733caaf18b80b7c2dcf70cc177\">\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=\"Post Intent Find And Buy - Stella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"find-and-add + create a Stella-hosted checkout the customer taps to pay. Returns {checkout_url, requires_confirmation: true}. Stella NEVER auto-pays — the customer is always the final approver. Phase 6 decision C2. Budget consumption happens at ORDER creation in CheckoutFinalizer.finalize (decision A5), NOT here. The pre-flight 402 catches obvious cap breaches early but doesn\u0026#x27;t reserve budget — this means an agent COULD create N checkouts that cumulatively exceed the cap, but only the ones the customer actually pays for consume budget.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stella-a663a7ad.mintlify.app/_mintlify/api/og/v2?division=Agent\u0026amp;title=Post+Intent+Find+And+Buy\u0026amp;description=find-and-add+%2B+create+a+Stella-hosted+checkout+the+customer%0Ataps+to+pay.%0A%0AReturns+%60%7Bcheckout_url%2C+requires_confirmation%3A+true%7D%60.+Stella%0ANEVER+auto-pays+%E2%80%94+the+cu\u0026amp;theme=4856e7f14517874ee4dfeeb7\u0026amp;signature=8fe72d0608c0244890cc158fb41381d1d54811733caaf18b80b7c2dcf70cc177\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/stella-a663a7ad/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stella\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0EA5E9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agent/post-intent-find-and-buy.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.stella-commerce.com/#organization\",\"name\":\"Stella\",\"url\":\"https://docs.stella-commerce.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.stella-commerce.com#website\",\"name\":\"Stella\",\"url\":\"https://docs.stella-commerce.com\",\"publisher\":{\"@id\":\"https://docs.stella-commerce.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy#webpage\",\"url\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy\",\"name\":\"Post Intent Find And Buy\",\"description\":\"find-and-add + create a Stella-hosted checkout the customer taps to pay. Returns {checkout_url, requires_confirmation: true}. Stella NEVER auto-pays — the customer is always the final approver. Phase 6 decision C2. Budget consumption happens at ORDER creation in CheckoutFinalizer.finalize (decision A5), NOT here. The pre-flight 402 catches obvious cap breaches early but doesn't reserve budget — this means an agent COULD create N checkouts that cumulatively exceed the cap, but only the ones the customer actually pays for consume budget.\",\"dateModified\":\"2026-05-21T08:25:36.072Z\",\"isPartOf\":{\"@id\":\"https://docs.stella-commerce.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agent\",\"item\":\"https://docs.stella-commerce.com/api-reference/agent/post-consent-request\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Post Intent Find And Buy\",\"item\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy#apireference\",\"headline\":\"Post Intent Find And Buy\",\"name\":\"Post Intent Find And Buy\",\"description\":\"find-and-add + create a Stella-hosted checkout the customer taps to pay. Returns {checkout_url, requires_confirmation: true}. Stella NEVER auto-pays — the customer is always the final approver. Phase 6 decision C2. Budget consumption happens at ORDER creation in CheckoutFinalizer.finalize (decision A5), NOT here. The pre-flight 402 catches obvious cap breaches early but doesn't reserve budget — this means an agent COULD create N checkouts that cumulatively exceed the cap, but only the ones the customer actually pays for consume budget.\",\"url\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy\",\"mainEntityOfPage\":{\"@id\":\"https://docs.stella-commerce.com/api-reference/agent/post-intent-find-and-buy#webpage\"},\"dateModified\":\"2026-05-21T08:25:36.072Z\",\"publisher\":{\"@id\":\"https://docs.stella-commerce.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.stella-commerce.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stella\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Stella","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Dashboard","pages":[{"title":"Read Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/me","href":"/api-reference/dashboard/read-me"},{"title":"List Invites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/invites","href":"/api-reference/dashboard/list-invites"},{"title":"Create Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/invites","href":"/api-reference/dashboard/create-invite"},{"title":"Revoke Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/invites/{invite_id}","href":"/api-reference/dashboard/revoke-invite"},{"title":"Validate Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/invites/validate","href":"/api-reference/dashboard/validate-invite"},{"title":"Accept Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/invites/accept","href":"/api-reference/dashboard/accept-invite"},{"title":"List Team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/team","href":"/api-reference/dashboard/list-team"},{"title":"Remove Team Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/team/{user_id}","href":"/api-reference/dashboard/remove-team-member"},{"title":"Change Team Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/team/{user_id}","href":"/api-reference/dashboard/change-team-role"},{"title":"List Products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/products","href":"/api-reference/dashboard/list-products"},{"title":"Create Product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/products","href":"/api-reference/dashboard/create-product"},{"title":"Get Product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/products/{product_id}","href":"/api-reference/dashboard/get-product"},{"title":"Update Product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/products/{product_id}","href":"/api-reference/dashboard/update-product"},{"title":"Delete Product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/products/{product_id}","href":"/api-reference/dashboard/delete-product"},{"title":"List Variants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/products/{product_id}/variants","href":"/api-reference/dashboard/list-variants"},{"title":"Create Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/products/{product_id}/variants","href":"/api-reference/dashboard/create-variant"},{"title":"Update Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/products/{product_id}/variants/{variant_id}","href":"/api-reference/dashboard/update-variant"},{"title":"Delete Variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/products/{product_id}/variants/{variant_id}","href":"/api-reference/dashboard/delete-variant"},{"title":"Get Image Upload Url","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/products/{product_id}/images/upload-url","href":"/api-reference/dashboard/get-image-upload-url"},{"title":"Update Options","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/products/{product_id}/options","href":"/api-reference/dashboard/update-options"},{"title":"Generate Variants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/products/{product_id}/variants/generate","href":"/api-reference/dashboard/generate-variants"},{"title":"List Inventory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/inventory","href":"/api-reference/dashboard/list-inventory"},{"title":"Get Inventory Summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/inventory/summary","href":"/api-reference/dashboard/get-inventory-summary"},{"title":"Get Low Stock Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/inventory/low-stock","href":"/api-reference/dashboard/get-low-stock-items"},{"title":"Adjust Inventory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/inventory/adjust","href":"/api-reference/dashboard/adjust-inventory"},{"title":"List Adjustments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/inventory/adjustments","href":"/api-reference/dashboard/list-adjustments"},{"title":"List Orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/orders","href":"/api-reference/dashboard/list-orders"},{"title":"Get Order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/orders/{order_id}","href":"/api-reference/dashboard/get-order"},{"title":"Update Order Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/orders/{order_id}/status","href":"/api-reference/dashboard/update-order-status"},{"title":"Fulfill Order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/orders/{order_id}/fulfill","href":"/api-reference/dashboard/fulfill-order"},{"title":"Cancel Order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/orders/{order_id}/cancel","href":"/api-reference/dashboard/cancel-order"},{"title":"Bank Transfer Mark Paid","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/orders/{order_id}/mark-paid","href":"/api-reference/dashboard/bank-transfer-mark-paid"},{"title":"Cod Mark Collected","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/orders/{order_id}/cod/mark-collected","href":"/api-reference/dashboard/cod-mark-collected"},{"title":"Cod Mark Failed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/orders/{order_id}/cod/mark-failed","href":"/api-reference/dashboard/cod-mark-failed"},{"title":"List Customers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers","href":"/api-reference/dashboard/list-customers"},{"title":"Get Customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers/{customer_id}","href":"/api-reference/dashboard/get-customer"},{"title":"Get Customer By Email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers/email/{email}","href":"/api-reference/dashboard/get-customer-by-email"},{"title":"List Customer Saved Addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers/{customer_id}/addresses","href":"/api-reference/dashboard/list-customer-saved-addresses"},{"title":"List Customer Sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers/{customer_id}/sessions","href":"/api-reference/dashboard/list-customer-sessions"},{"title":"Revoke Customer Session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/customers/{customer_id}/sessions/{token_id}/revoke","href":"/api-reference/dashboard/revoke-customer-session"},{"title":"List Customer Audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/customers/{customer_id}/audit","href":"/api-reference/dashboard/list-customer-audit"},{"title":"Reset Customer Lockout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/customers/{customer_id}/reset-lockout","href":"/api-reference/dashboard/reset-customer-lockout"},{"title":"List Collections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/collections","href":"/api-reference/dashboard/list-collections"},{"title":"Create Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/collections","href":"/api-reference/dashboard/create-collection"},{"title":"Get Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/collections/{collection_id}","href":"/api-reference/dashboard/get-collection"},{"title":"Update Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/collections/{collection_id}","href":"/api-reference/dashboard/update-collection"},{"title":"Delete Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/collections/{collection_id}","href":"/api-reference/dashboard/delete-collection"},{"title":"Add Products To Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/collections/{collection_id}/products","href":"/api-reference/dashboard/add-products-to-collection"},{"title":"Remove Products From Collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/collections/{collection_id}/products","href":"/api-reference/dashboard/remove-products-from-collection"},{"title":"Reorder Collection Products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/collections/{collection_id}/products/reorder","href":"/api-reference/dashboard/reorder-collection-products"},{"title":"List Sync Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/sync-keys","href":"/api-reference/dashboard/list-sync-keys"},{"title":"Create Sync Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/sync-keys","href":"/api-reference/dashboard/create-sync-key"},{"title":"Revoke Sync Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/sync-keys/{key_id}","href":"/api-reference/dashboard/revoke-sync-key"},{"title":"List Storefront Tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/storefront-tokens","href":"/api-reference/dashboard/list-storefront-tokens"},{"title":"Create Storefront Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/storefront-tokens","href":"/api-reference/dashboard/create-storefront-token"},{"title":"Revoke Storefront Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/storefront-tokens/{key_id}","href":"/api-reference/dashboard/revoke-storefront-token"},{"title":"Update Storefront Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/storefront-tokens/{key_id}","href":"/api-reference/dashboard/update-storefront-token"},{"title":"Rotate Storefront Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/storefront-tokens/{key_id}/rotate","href":"/api-reference/dashboard/rotate-storefront-token"},{"title":"Overview","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/analytics/overview","href":"/api-reference/dashboard/overview"},{"title":"Revenue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/analytics/revenue","href":"/api-reference/dashboard/revenue"},{"title":"Top Products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/analytics/top-products","href":"/api-reference/dashboard/top-products"},{"title":"Get Settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/settings","href":"/api-reference/dashboard/get-settings"},{"title":"Update Settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/settings","href":"/api-reference/dashboard/update-settings"},{"title":"Connect Zunkiree","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/integrations/zunkiree/connect","href":"/api-reference/dashboard/connect-zunkiree"},{"title":"Get Integration Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/integrations/zunkiree","href":"/api-reference/dashboard/get-integration-status"},{"title":"Patch Widget Config","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/integrations/zunkiree/widget-config","href":"/api-reference/dashboard/patch-widget-config"},{"title":"Rotate Sync Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/integrations/zunkiree/rotate-sync-key","href":"/api-reference/dashboard/rotate-sync-key"},{"title":"Get Analytics Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/integrations/zunkiree/analytics","href":"/api-reference/dashboard/get-analytics-endpoint"},{"title":"List Redirects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/redirects","href":"/api-reference/dashboard/list-redirects"},{"title":"Create Redirect","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/redirects","href":"/api-reference/dashboard/create-redirect"},{"title":"Delete Redirect","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/redirects/{redirect_id}","href":"/api-reference/dashboard/delete-redirect"},{"title":"Update Redirect","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/redirects/{redirect_id}","href":"/api-reference/dashboard/update-redirect"},{"title":"List Discount Codes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/discount-codes","href":"/api-reference/dashboard/list-discount-codes"},{"title":"Create Discount Code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/discount-codes","href":"/api-reference/dashboard/create-discount-code"},{"title":"Revoke Discount Code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/discount-codes/{code_id}","href":"/api-reference/dashboard/revoke-discount-code"},{"title":"Update Discount Code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/discount-codes/{code_id}","href":"/api-reference/dashboard/update-discount-code"},{"title":"List Webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/webhooks","href":"/api-reference/dashboard/list-webhooks"},{"title":"Register Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/webhooks","href":"/api-reference/dashboard/register-webhook"},{"title":"Deactivate Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/webhooks/{registration_id}","href":"/api-reference/dashboard/deactivate-webhook"},{"title":"List Deliveries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/webhooks/{registration_id}/deliveries","href":"/api-reference/dashboard/list-deliveries"},{"title":"Retry Delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/webhooks/deliveries/{delivery_id}/retry","href":"/api-reference/dashboard/retry-delivery"},{"title":"Get Checkout Theme","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/merchant/checkout-theme","href":"/api-reference/dashboard/get-checkout-theme"},{"title":"Update Checkout Theme","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/merchant/checkout-theme","href":"/api-reference/dashboard/update-checkout-theme"},{"title":"List Tax Rates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/tax-rates","href":"/api-reference/dashboard/list-tax-rates"},{"title":"Create Tax Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/tax-rates","href":"/api-reference/dashboard/create-tax-rate"},{"title":"Delete Tax Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/tax-rates/{rate_id}","href":"/api-reference/dashboard/delete-tax-rate"},{"title":"Update Tax Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/tax-rates/{rate_id}","href":"/api-reference/dashboard/update-tax-rate"},{"title":"List Zones","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/shipping-zones","href":"/api-reference/dashboard/list-zones"},{"title":"Create Zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/shipping-zones","href":"/api-reference/dashboard/create-zone"},{"title":"Delete Zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/shipping-zones/{zone_id}","href":"/api-reference/dashboard/delete-zone"},{"title":"Update Zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/shipping-zones/{zone_id}","href":"/api-reference/dashboard/update-zone"},{"title":"Create Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/dashboard/shipping-zones/{zone_id}/rates","href":"/api-reference/dashboard/create-rate"},{"title":"Delete Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/dashboard/shipping-zones/{zone_id}/rates/{rate_id}","href":"/api-reference/dashboard/delete-rate"},{"title":"Update Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/dashboard/shipping-zones/{zone_id}/rates/{rate_id}","href":"/api-reference/dashboard/update-rate"},{"title":"Get Payment Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/payment-status","href":"/api-reference/dashboard/get-payment-status"},{"title":"List Payment Methods","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/dashboard/payment-methods","href":"/api-reference/dashboard/list-payment-methods"},{"title":"Upsert Payment Method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/dashboard/payment-methods/{method}","href":"/api-reference/dashboard/upsert-payment-method"}]},{"group":"Storefront","pages":[{"title":"List Products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/products","href":"/api-reference/storefront/list-products"},{"title":"Get Product By Slug","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/products/{slug}","href":"/api-reference/storefront/get-product-by-slug"},{"title":"Check Availability","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/products/{product_id}/availability","href":"/api-reference/storefront/check-availability"},{"title":"List Collections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/collections","href":"/api-reference/storefront/list-collections"},{"title":"Get Collection By Handle","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/collections/{handle}","href":"/api-reference/storefront/get-collection-by-handle"},{"title":"Create Cart","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/cart","href":"/api-reference/storefront/create-cart"},{"title":"Get Cart","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/cart/{cart_id}","href":"/api-reference/storefront/get-cart"},{"title":"Add Item To Cart","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/cart/{cart_id}/items","href":"/api-reference/storefront/add-item-to-cart"},{"title":"Update Cart Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/storefront/cart/{cart_id}/items/{item_id}","href":"/api-reference/storefront/update-cart-item"},{"title":"Remove Cart Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/storefront/cart/{cart_id}/items/{item_id}","href":"/api-reference/storefront/remove-cart-item"},{"title":"Attach Buyer Identity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/cart/{cart_id}/buyer-identity","href":"/api-reference/storefront/attach-buyer-identity"},{"title":"Apply Discount","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/cart/{cart_id}/discounts","href":"/api-reference/storefront/apply-discount"},{"title":"Remove Discount","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/storefront/cart/{cart_id}/discounts","href":"/api-reference/storefront/remove-discount"},{"title":"Create Checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/checkout","href":"/api-reference/storefront/create-checkout"},{"title":"Get Checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/checkout/{checkout_id}","href":"/api-reference/storefront/get-checkout"},{"title":"List Payment Methods","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/checkout/{checkout_id}/payment-methods","href":"/api-reference/storefront/list-payment-methods"},{"title":"Complete Checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/checkout/{checkout_id}/complete","href":"/api-reference/storefront/complete-checkout"},{"title":"Create Payment Intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/checkout/{checkout_id}/payment-intent","href":"/api-reference/storefront/create-payment-intent"},{"title":"Register","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/register","href":"/api-reference/storefront/register"},{"title":"Login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/login","href":"/api-reference/storefront/login"},{"title":"Recover","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/recover","href":"/api-reference/storefront/recover"},{"title":"Reset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/reset","href":"/api-reference/storefront/reset"},{"title":"Verify Email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/verify-email","href":"/api-reference/storefront/verify-email"},{"title":"Logout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/logout","href":"/api-reference/storefront/logout"},{"title":"Renew Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/token/renew","href":"/api-reference/storefront/renew-token"},{"title":"Resend Verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/resend-verification","href":"/api-reference/storefront/resend-verification"},{"title":"Get Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me","href":"/api-reference/storefront/get-me"},{"title":"Patch Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/storefront/customer/me","href":"/api-reference/storefront/patch-me"},{"title":"List My Orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/orders","href":"/api-reference/storefront/list-my-orders"},{"title":"Get My Order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/orders/{order_id}","href":"/api-reference/storefront/get-my-order"},{"title":"List Addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/addresses","href":"/api-reference/storefront/list-addresses"},{"title":"Create Address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/me/addresses","href":"/api-reference/storefront/create-address"},{"title":"Delete Address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/storefront/customer/me/addresses/{address_id}","href":"/api-reference/storefront/delete-address"},{"title":"Patch Address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/storefront/customer/me/addresses/{address_id}","href":"/api-reference/storefront/patch-address"},{"title":"Set Default Address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/me/addresses/{address_id}/default","href":"/api-reference/storefront/set-default-address"},{"title":"Get Consent Preview","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/agent-consent/{user_code}","href":"/api-reference/storefront/get-consent-preview"},{"title":"Post Approve","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/me/agent-consent/{user_code}/approve","href":"/api-reference/storefront/post-approve"},{"title":"Post Deny","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/storefront/customer/me/agent-consent/{user_code}/deny","href":"/api-reference/storefront/post-deny"},{"title":"List My Agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/agents","href":"/api-reference/storefront/list-my-agents"},{"title":"Revoke My Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/storefront/customer/me/agents/{agent_token_id}","href":"/api-reference/storefront/revoke-my-agent"},{"title":"Get My Agent Audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/customer/me/agents/{agent_token_id}/audit","href":"/api-reference/storefront/get-my-agent-audit"},{"title":"Predictive Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/search/predictive","href":"/api-reference/storefront/predictive-search"},{"title":"Full Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/search","href":"/api-reference/storefront/full-search"},{"title":"Lookup Redirect","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/redirects","href":"/api-reference/storefront/lookup-redirect"},{"title":"Sitemap","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/sitemap.xml","href":"/api-reference/storefront/sitemap"},{"title":"Get Theme","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/theme","href":"/api-reference/storefront/get-theme"},{"title":"List Shipping Options","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/storefront/shipping-options","href":"/api-reference/storefront/list-shipping-options"}]},{"group":"Sync","pages":[{"title":"List Products For Sync","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/products","href":"/api-reference/sync/list-products-for-sync"},{"title":"Get Product For Sync","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/products/{product_id}","href":"/api-reference/sync/get-product-for-sync"},{"title":"Check Availability","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/availability","href":"/api-reference/sync/check-availability"},{"title":"Create Order From Ai","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sync/orders","href":"/api-reference/sync/create-order-from-ai"},{"title":"Register Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sync/webhook/register","href":"/api-reference/sync/register-webhook"},{"title":"List Webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/webhook","href":"/api-reference/sync/list-webhooks"},{"title":"Delete Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/sync/webhook/{webhook_id}","href":"/api-reference/sync/delete-webhook"}]},{"group":"Sync v1","pages":[{"title":"List Products For Sync","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/v1/products","href":"/api-reference/sync-v1/list-products-for-sync"},{"title":"Get Product For Sync","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/v1/products/{product_id}","href":"/api-reference/sync-v1/get-product-for-sync"},{"title":"Check Availability","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/v1/availability","href":"/api-reference/sync-v1/check-availability"},{"title":"Create Order From Ai","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sync/v1/orders","href":"/api-reference/sync-v1/create-order-from-ai"},{"title":"List Webhooks V1","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/v1/webhooks","href":"/api-reference/sync-v1/list-webhooks-v1"},{"title":"Register Webhook V1","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sync/v1/webhooks","href":"/api-reference/sync-v1/register-webhook-v1"},{"title":"Deactivate Webhook V1","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/sync/v1/webhooks/{registration_id}","href":"/api-reference/sync-v1/deactivate-webhook-v1"},{"title":"List Deliveries V1","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/sync/v1/webhooks/{registration_id}/deliveries","href":"/api-reference/sync-v1/list-deliveries-v1"},{"title":"Retry Delivery V1","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/sync/v1/webhooks/deliveries/{delivery_id}/retry","href":"/api-reference/sync-v1/retry-delivery-v1"}]},{"group":"Webhooks","pages":[{"title":"Stripe Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/webhooks/stripe","href":"/api-reference/webhooks/stripe-webhook"}]},{"group":"Agent","pages":[{"title":"Post Consent Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/consent/request","href":"/api-reference/agent/post-consent-request"},{"title":"Post Consent Poll","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/consent/poll","href":"/api-reference/agent/post-consent-poll"},{"title":"Get Catalog Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/agent/catalog/search","href":"/api-reference/agent/get-catalog-search"},{"title":"Get Agent Customer Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/agent/customer/me","href":"/api-reference/agent/get-agent-customer-me"},{"title":"Get Agent Audit Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/agent/audit/me","href":"/api-reference/agent/get-agent-audit-me"},{"title":"Post Intent Find","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/intent/find","href":"/api-reference/agent/post-intent-find"},{"title":"Post Intent Find And Add","description":"Find the top product matching `query`, pick the cheapest\nin-stock variant within budget, and add it to a fresh cart owned\nby the agent's customer.\n\nDecision (A) from kickoff: always create a NEW cart per call.\nPredictable for agents that chain find-and-add → find-and-buy on\nthe cart they just received. The customer's storefront cart is\nuntouched.\n\nPre-flight budget check raises 402 before creating the cart so\nthe agent can fail fast on intents that exceed the cap.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/intent/find-and-add","href":"/api-reference/agent/post-intent-find-and-add"},{"title":"Post Intent Find And Buy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent/intent/find-and-buy","href":"/api-reference/agent/post-intent-find-and-buy"}]},{"group":"API Reference","pages":[{"title":"Health Check","description":"Health check endpoint.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/health-check"},{"title":"Root","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /","href":"/api-reference/root"}]}]}]},"basePath":"","title":"Post Intent Find And Buy - Stella","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}