Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported.
Images: put chat-style parts such as {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}} anywhere in state or a question’s instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway’s whole-request body limit (20 MiB by default).
POST
/
v1
/
decisions
cURL
curl https://api.inceptionlabs.ai/v1/decisions -H "Authorization: Bearer $INCEPTION_API_KEY" -H "Content-Type: application/json" -d '{ "model": "mercury-decide", "state": { "message": "Please refund the duplicate charge on my account." }, "questions": { "billing": { "type": "noul", "instructions": "Is this request about billing?" }, "team": { "type": "choice", "criteria": { "billing": "Payments, charges, and refunds", "support": "Technical support and other requests" } }, "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": [ "Can wait", "Needs attention soon", "Needs immediate attention" ] } }}'
import json
import os
import urllib.request
payload = {
"model": "mercury-decide",
"state": {
"message": "Please refund the duplicate charge on my account."
},
"questions": {
"billing": {
"type": "noul",
"instructions": "Is this request about billing?"
},
"team": {
"type": "choice",
"criteria": {
"billing": "Payments, charges, and refunds",
"support": "Technical support and other requests"
}
},
"urgency": {
"type": "score",
"instructions": "How urgent is this request?",
"criteria": [
"Can wait",
"Needs attention soon",
"Needs immediate attention"
]
}
}
}
request = urllib.request.Request('https://api.inceptionlabs.ai/v1/decisions',
data=json.dumps(payload).encode(),
headers={"Authorization": f"Bearer {os.environ['INCEPTION_API_KEY']}",
"Content-Type": "application/json"}, method="POST")
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response)["answers"])
const response = await fetch('https://api.inceptionlabs.ai/v1/decisions', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.INCEPTION_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "mercury-decide",
"state": {
"message": "Please refund the duplicate charge on my account."
},
"questions": {
"billing": {
"type": "noul",
"instructions": "Is this request about billing?"
},
"team": {
"type": "choice",
"criteria": {
"billing": "Payments, charges, and refunds",
"support": "Technical support and other requests"
}
},
"urgency": {
"type": "score",
"instructions": "How urgent is this request?",
"criteria": [
"Can wait",
"Needs attention soon",
"Needs immediate attention"
]
}
}
}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).answers);
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'mercury-decide',
state: {message: 'Please refund the duplicate charge on my account.'},
questions: {
billing: {type: 'noul', instructions: 'Is this request about billing?'},
team: {
type: 'choice',
criteria: {
billing: 'Payments, charges, and refunds',
support: 'Technical support and other requests'
}
},
urgency: {
type: 'score',
instructions: 'How urgent is this request?',
criteria: ['Can wait', 'Needs attention soon', 'Needs immediate attention']
}
}
})
};
fetch('https://api.inceptionlabs.ai/v1/decisions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
{ "message": "Please refund the duplicate charge on my account." }
questions
Questions · object
required
Show child attributes
Example:
{ "billing": { "type": "noul", "instructions": "Is this request about billing?" }, "team": { "type": "choice", "criteria": { "billing": "Payments, charges, and refunds", "support": "Technical support and other requests" } }, "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": [ "Can wait", "Needs attention soon", "Needs immediate attention" ] } }
Response
Successful Response
model
string
required
Minimum string length: 1
answers
Answers · object
required
Show child attributes
usage
DecisionUsage · object
required
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Inception Platform","colors":{"primary":"#2C9AF2","light":"#2C9AF2","dark":"#00345C"},"logo":{"light":"https://mintcdn.com/inception/dMlmOrVe7c7dQ19H/logo/light-logo.svg?fit=max\u0026auto=format\u0026n=dMlmOrVe7c7dQ19H\u0026q=85\u0026s=f1e7c8ed94cb5ce8d826b26886a914b3","dark":"https://mintcdn.com/inception/dMlmOrVe7c7dQ19H/logo/dark-logo.svg?fit=max\u0026auto=format\u0026n=dMlmOrVe7c7dQ19H\u0026q=85\u0026s=76b32d8d8672accebbd3b82a10e6bfbc"},"favicon":{"light":"https://mintcdn.com/inception/dMlmOrVe7c7dQ19H/favicon.svg?fit=max\u0026auto=format\u0026n=dMlmOrVe7c7dQ19H\u0026q=85\u0026s=6a61e9589869435a9e69cce9e0bb65c9","dark":"https://mintcdn.com/inception/dMlmOrVe7c7dQ19H/favicon-dark.svg?fit=max\u0026auto=format\u0026n=dMlmOrVe7c7dQ19H\u0026q=85\u0026s=4a6e4eb0e0c8fc9e392094013040a06c"},"api":{"openapi":"https://api.inceptionlabs.ai/openapi.json","playground":{"display":"interactive"},"examples":{"defaults":"required","prefill":true,"autogenerate":true}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.inceptionlabs.ai/"}},"footer":{"socials":{"x":"https://x.com/_inception_ai","linkedin":"https://www.linkedin.com/company/inception-labs-ai","discord":"https://discord.com/invite/btzTARamwH"}},"seo":{"indexing":"navigable"},"integrations":{"ga4":{"measurementId":"G-HX11RSR827"},"telemetry":{"enabled":true}},"banner":{"content":"**The Mercury API is winding down and will remain available through December 28, 2026.** Retrieve any data you need before then. [Learn more →](/support/wind-down)","dismissible":false},"contextual":{"options":["copy","view"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"inception","hasAudioNarration":false,"actualSubdomain":"inception","customDomains":["docs.inceptionlabs.ai"],"gitSource":{"type":"github","owner":"inception-ai-inc","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af62d4073ab56d16b09dae2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":17},{"language":"default","tag":"Integrations","count":10},{"language":"default","tag":"Capabilities","count":8},{"language":"default","tag":"API reference","count":8},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Cookbooks","count":5},{"language":"default","tag":"Support","count":4},{"language":"default","tag":"Models","count":4},{"language":"default","tag":"Resources","count":3},{"language":"default","tag":"Chat","count":1}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/decisions/create-a-decision","slug":"/api-reference/decisions/create-a-decision","pageMetadata":{"title":"Create a decision","description":"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (`noul`), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported.\n\nImages: put chat-style parts such as `{\"type\": \"image_url\", \"image_url\": {\"url\": \"data:image/png;base64,...\"}}` anywhere in `state` or a question's `instructions` (not in `criteria`). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway's whole-request body limit (20 MiB by default).","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/decisions","href":"/api-reference/decisions/create-a-decision","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: [_jsxs(_components.p, {\n children: [\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (\", _jsx(_components.code, {\n children: \"noul\"\n }), \"), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Images: put chat-style parts such as \", _jsx(_components.code, {\n children: \"{\\\"type\\\": \\\"image_url\\\", \\\"image_url\\\": {\\\"url\\\": \\\"data:image/png;base64,...\\\"}}\"\n }), \" anywhere in \", _jsx(_components.code, {\n children: \"state\"\n }), \" or a question’s \", _jsx(_components.code, {\n children: \"instructions\"\n }), \" (not in \", _jsx(_components.code, {\n children: \"criteria\"\n }), \"). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway’s whole-request body limit (20 MiB by default).\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a decision","description":"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (`noul`), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported.\n\nImages: put chat-style parts such as `{\"type\": \"image_url\", \"image_url\": {\"url\": \"data:image/png;base64,...\"}}` anywhere in `state` or a question's `instructions` (not in `criteria`). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway's whole-request body limit (20 MiB by default).","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/decisions","href":"/api-reference/decisions/create-a-decision","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a decision","operationId":"createDecision","requestBody":"168b9d18-2627-485a-9d81-87395778348a","responses":{"200":"926fa591-52e4-4505-96af-072650b66df4","401":"0b04d859-7109-4a09-b9f7-bc420de9c035","402":"f010d2ea-20b4-498f-9bee-c99dee356b0d","404":"707ae515-3079-4108-8cfe-3812c57734de","413":"c1c1902b-12af-49e6-ba4e-34cf3ceb06cd","422":"0ebf03aa-e677-407d-a465-3a057373cec7","429":"cc9f0614-4b6e-49b1-ab7f-e34cf037476e","500":"89904e20-627f-4c56-a197-2d874be6b402","502":"ebb58ce0-8ace-41c0-a6fc-16f2e02f6153","503":"34dbeacf-4bb3-4efb-8359-1b4a9c81eab3","504":"abcf0c2b-56a7-4be2-97a7-c8d078c47e9a"},"security":["38e5e4b5-f49c-4ae4-839f-552c25e1143f"],"tags":["Decisions"],"description":"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (`noul`), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported.\n\nImages: put chat-style parts such as `{\"type\": \"image_url\", \"image_url\": {\"url\": \"data:image/png;base64,...\"}}` anywhere in `state` or a question's `instructions` (not in `criteria`). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway's whole-request body limit (20 MiB by default).","x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl https://api.inceptionlabs.ai/v1/decisions -H \"Authorization: Bearer $INCEPTION_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}'\n"},{"lang":"python","label":"Python","source":"import json\nimport os\nimport urllib.request\n\npayload = {\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}\nrequest = urllib.request.Request('https://api.inceptionlabs.ai/v1/decisions',\n data=json.dumps(payload).encode(),\n headers={\"Authorization\": f\"Bearer {os.environ['INCEPTION_API_KEY']}\",\n \"Content-Type\": \"application/json\"}, method=\"POST\")\nwith urllib.request.urlopen(request, timeout=60) as response:\n print(json.load(response)[\"answers\"])\n"},{"lang":"typescript","label":"TypeScript","source":"const response = await fetch('https://api.inceptionlabs.ai/v1/decisions', {\n method: 'POST',\n headers: {\n Authorization: `Bearer ${process.env.INCEPTION_API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}),\n});\nif (!response.ok) throw new Error(await response.text());\nconsole.log((await response.json()).answers);\n"}],"method":"post","type":"path","servers":["05e90beb-3e99-4534-9f7d-e73d81b09d3f"],"path":"/v1/decisions","baseUrlOptions":["https://api.inceptionlabs.ai"],"title":"Create a decision","codeSamples":[{"label":"cURL","lang":"bash","source":"curl https://api.inceptionlabs.ai/v1/decisions -H \"Authorization: Bearer $INCEPTION_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}'\n"},{"label":"Python","lang":"python","source":"import json\nimport os\nimport urllib.request\n\npayload = {\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}\nrequest = urllib.request.Request('https://api.inceptionlabs.ai/v1/decisions',\n data=json.dumps(payload).encode(),\n headers={\"Authorization\": f\"Bearer {os.environ['INCEPTION_API_KEY']}\",\n \"Content-Type\": \"application/json\"}, method=\"POST\")\nwith urllib.request.urlopen(request, timeout=60) as response:\n print(json.load(response)[\"answers\"])\n"},{"label":"TypeScript","lang":"typescript","source":"const response = await fetch('https://api.inceptionlabs.ai/v1/decisions', {\n method: 'POST',\n headers: {\n Authorization: `Bearer ${process.env.INCEPTION_API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n \"model\": \"mercury-decide\",\n \"state\": {\n \"message\": \"Please refund the duplicate charge on my account.\"\n },\n \"questions\": {\n \"billing\": {\n \"type\": \"noul\",\n \"instructions\": \"Is this request about billing?\"\n },\n \"team\": {\n \"type\": \"choice\",\n \"criteria\": {\n \"billing\": \"Payments, charges, and refunds\",\n \"support\": \"Technical support and other requests\"\n }\n },\n \"urgency\": {\n \"type\": \"score\",\n \"instructions\": \"How urgent is this request?\",\n \"criteria\": [\n \"Can wait\",\n \"Needs attention soon\",\n \"Needs immediate attention\"\n ]\n }\n }\n}),\n});\nif (!response.ok) throw new Error(await response.text());\nconsole.log((await response.json()).answers);\n"}],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.model":"mercury-decide","body.state.oneOf.1.message":"Please refund the duplicate charge on my account.","body.questions.billing.oneOf.0.type":"noul","body.questions.billing.oneOf.0.instructions.oneOf.0":"Is this request about billing?","body.questions.team.oneOf.1.type":"choice","body.questions.team.oneOf.1.criteria.billing.oneOf.0":"Payments, charges, and refunds","body.questions.team.oneOf.1.criteria.support.oneOf.0":"Technical support and other requests","body.questions.urgency.oneOf.2.type":"score","body.questions.urgency.oneOf.2.criteria.items.0.oneOf.0":"Can wait","body.questions.urgency.oneOf.2.criteria.items.1.oneOf.0":"Needs attention soon","body.questions.urgency.oneOf.2.criteria.items.2.oneOf.0":"Needs immediate attention","body.questions.urgency.oneOf.2.instructions.oneOf.0":"How urgent is this request?"}]},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"model":{"type":"string","minLength":1,"title":"Model","example":"mercury-decide","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"state":{"oneOf":[{"type":"string","title":"State","example":{"message":"Please refund the duplicate charge on my account."},"isRequired":true,"uniqueKey":"state.oneOf.0","typeLabel":"string"},{"type":"object","title":"State","example":{"message":"Please refund the duplicate charge on my account."},"additionalProperties":{"required":[],"uniqueKey":"state.oneOf.1.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"state.oneOf.1","typeLabel":"State · object"},{"type":"array","items":{"required":[],"uniqueKey":"state.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"State","example":{"message":"Please refund the duplicate charge on my account."},"isRequired":true,"uniqueKey":"state.oneOf.2","typeLabel":"any[]"}],"isRequired":true,"uniqueKey":"state","typeLabel":"string | State · object | any[]"},"questions":{"additionalProperties":{"oneOf":[{"type":"object","title":"NoulQuestion","required":["type"],"properties":{"type":{"type":"string","const":"noul","title":"Type","isRequired":true,"uniqueKey":"questions.additionalProperties.oneOf.0.type","typeLabel":"string"},"instructions":{"oneOf":[{"type":"string","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.0","typeLabel":"string"},{"type":"object","title":"Instructions","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.1","typeLabel":"Instructions · object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.2","typeLabel":"any[]"},{"type":"null","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.0.instructions.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.0.instructions","typeLabel":"string | Instructions · object | any[] | null"},"criteria":{"oneOf":[{"type":"object","title":"NoulCriteria","required":[],"properties":{"true":{"oneOf":[{"type":"string","title":"True","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.0","typeLabel":"string"},{"type":"object","title":"True","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.1","typeLabel":"True · object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"True","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.2","typeLabel":"any[]"},{"type":"null","title":"True","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.true","typeLabel":"string | True · object | any[] | null"},"false":{"oneOf":[{"type":"string","title":"False","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.0","typeLabel":"string"},{"type":"object","title":"False","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.1","typeLabel":"False · object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"False","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.2","typeLabel":"any[]"},{"type":"null","title":"False","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0.false","typeLabel":"string | False · object | any[] | null"}},"uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.0","typeLabel":"NoulCriteria · object"},{"type":"null","uniqueKey":"questions.additionalProperties.oneOf.0.criteria.oneOf.1","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.0.criteria","typeLabel":"NoulCriteria · object | null"}},"uniqueKey":"questions.additionalProperties.oneOf.0","typeLabel":"NoulQuestion · object"},{"type":"object","title":"ChoiceQuestion","required":["type","criteria"],"properties":{"type":{"type":"string","const":"choice","title":"Type","isRequired":true,"uniqueKey":"questions.additionalProperties.oneOf.1.type","typeLabel":"string"},"criteria":{"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"object","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.1","typeLabel":"object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.2.items.[INDEX]","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.2","typeLabel":"any[]"},{"type":"null","uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.1.criteria.additionalProperties","typeLabel":"string | object | any[] | null"},"type":"object","maxProperties":255,"minProperties":1,"title":"Criteria","description":"Required mapping of 1 to 255 option labels to descriptions. Descriptions may be null, but criteria must not be omitted, null, or empty. Options are never inferred from instructions.","isRequired":true,"uniqueKey":"questions.additionalProperties.oneOf.1.criteria","typeLabel":"Criteria · object"},"instructions":{"oneOf":[{"type":"string","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.0","typeLabel":"string"},{"type":"object","title":"Instructions","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.1","typeLabel":"Instructions · object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.2","typeLabel":"any[]"},{"type":"null","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.1.instructions.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.1.instructions","typeLabel":"string | Instructions · object | any[] | null"}},"uniqueKey":"questions.additionalProperties.oneOf.1","typeLabel":"ChoiceQuestion · object"},{"type":"object","title":"ScoreQuestion","required":["type","criteria"],"properties":{"type":{"type":"string","const":"score","title":"Type","isRequired":true,"uniqueKey":"questions.additionalProperties.oneOf.2.type","typeLabel":"string"},"criteria":{"items":{"oneOf":[{"type":"string","uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX].oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX].oneOf.2.items.[INDEX]","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX].oneOf.2","typeLabel":"any[]"}],"uniqueKey":"questions.additionalProperties.oneOf.2.criteria.items.[INDEX]","typeLabel":"string | object | any[]"},"type":"array","maxItems":10,"minItems":1,"title":"Criteria","isRequired":true,"uniqueKey":"questions.additionalProperties.oneOf.2.criteria","typeLabel":"(string | object | any[])[]"},"instructions":{"oneOf":[{"type":"string","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.0","typeLabel":"string"},{"type":"object","title":"Instructions","additionalProperties":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.1","typeLabel":"Instructions · object"},{"type":"array","items":{"required":[],"uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.2.items.[INDEX]","typeLabel":"any"},"title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.2","typeLabel":"any[]"},{"type":"null","title":"Instructions","uniqueKey":"questions.additionalProperties.oneOf.2.instructions.oneOf.3","typeLabel":"null"}],"uniqueKey":"questions.additionalProperties.oneOf.2.instructions","typeLabel":"string | Instructions · object | any[] | null"}},"uniqueKey":"questions.additionalProperties.oneOf.2","typeLabel":"ScoreQuestion · object"}],"uniqueKey":"questions.additionalProperties","typeLabel":"NoulQuestion · object | ChoiceQuestion · object | ScoreQuestion · object"},"type":"object","minProperties":1,"title":"Questions","example":{"billing":{"type":"noul","instructions":"Is this request about billing?"},"team":{"type":"choice","criteria":{"billing":"Payments, charges, and refunds","support":"Technical support and other requests"}},"urgency":{"type":"score","instructions":"How urgent is this request?","criteria":["Can wait","Needs attention soon","Needs immediate attention"]}},"isRequired":true,"uniqueKey":"questions","typeLabel":"Questions · object"}},"type":"object","required":["model","state","questions"],"title":"DecisionRequest","example":{"model":"mercury-decide","state":{"message":"Please refund the duplicate charge on my account."},"questions":{"billing":{"type":"noul","instructions":"Is this request about billing?"},"team":{"type":"choice","criteria":{"billing":"Payments, charges, and refunds","support":"Technical support and other requests"}},"urgency":{"type":"score","instructions":"How urgent is this request?","criteria":["Can wait","Needs attention soon","Needs immediate attention"]}}},"uniqueKey":"","typeLabel":"DecisionRequest · object"},"example":{"model":"mercury-decide","state":{"message":"Please refund the duplicate charge on my account."},"questions":{"billing":{"type":"noul","instructions":"Is this request about billing?"},"team":{"type":"choice","criteria":{"billing":"Payments, charges, and refunds","support":"Technical support and other requests"}},"urgency":{"type":"score","instructions":"How urgent is this request?","criteria":["Can wait","Needs attention soon","Needs immediate attention"]}}},"examples":{"Example":{"title":"Example","value":{"model":"mercury-decide","state":{"message":"Please refund the duplicate charge on my account."},"questions":{"billing":{"type":"noul","instructions":"Is this request about billing?"},"team":{"type":"choice","criteria":{"billing":"Payments, charges, and refunds","support":"Technical support and other requests"}},"urgency":{"type":"score","instructions":"How urgent is this request?","criteria":["Can wait","Needs attention soon","Needs immediate attention"]}}}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"926fa591-52e4-4505-96af-072650b66df4":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"model":{"type":"string","minLength":1,"title":"Model","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"answers":{"additionalProperties":{"oneOf":[{"type":"object","title":"NoulAnswer","required":["type","noul"],"properties":{"type":{"type":"string","const":"noul","title":"Type","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.0.type","typeLabel":"string"},"noul":{"type":"number","maximum":1,"minimum":0,"title":"Noul","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.0.noul","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"answers.additionalProperties.oneOf.0","typeLabel":"NoulAnswer · object"},{"type":"object","title":"ChoiceAnswer","required":["type","choice","probabilities","confidence"],"properties":{"type":{"type":"string","const":"choice","title":"Type","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.1.type","typeLabel":"string"},"choice":{"type":"string","title":"Choice","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.1.choice","typeLabel":"string"},"probabilities":{"additionalProperties":{"type":"number","maximum":1,"minimum":0,"uniqueKey":"answers.additionalProperties.oneOf.1.probabilities.additionalProperties","typeLabel":"number"},"type":"object","title":"Probabilities","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.1.probabilities","typeLabel":"Probabilities · object"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.1.confidence","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"answers.additionalProperties.oneOf.1","typeLabel":"ChoiceAnswer · object"},{"type":"object","title":"ScoreAnswer","required":["type","score","legend","probabilities","confidence"],"properties":{"type":{"type":"string","const":"score","title":"Type","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.2.type","typeLabel":"string"},"score":{"type":"number","minimum":0,"title":"Score","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.2.score","typeLabel":"number"},"legend":{"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"object","additionalProperties":{"required":[],"uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties.oneOf.1","typeLabel":"object"},{"type":"array","items":{"required":[],"uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties.oneOf.2.items.[INDEX]","typeLabel":"any"},"uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties.oneOf.2","typeLabel":"any[]"}],"uniqueKey":"answers.additionalProperties.oneOf.2.legend.additionalProperties","typeLabel":"string | object | any[]"},"type":"object","title":"Legend","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.2.legend","typeLabel":"Legend · object"},"probabilities":{"additionalProperties":{"type":"number","maximum":1,"minimum":0,"uniqueKey":"answers.additionalProperties.oneOf.2.probabilities.additionalProperties","typeLabel":"number"},"type":"object","title":"Probabilities","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.2.probabilities","typeLabel":"Probabilities · object"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","isRequired":true,"uniqueKey":"answers.additionalProperties.oneOf.2.confidence","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"answers.additionalProperties.oneOf.2","typeLabel":"ScoreAnswer · object"}],"uniqueKey":"answers.additionalProperties","typeLabel":"NoulAnswer · object | ChoiceAnswer · object | ScoreAnswer · object"},"type":"object","minProperties":1,"title":"Answers","isRequired":true,"uniqueKey":"answers","typeLabel":"Answers · object"},"usage":{"properties":{"input_tokens":{"type":"integer","minimum":0,"title":"Input Tokens","isRequired":true,"uniqueKey":"usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","minimum":0,"title":"Output Tokens","isRequired":true,"uniqueKey":"usage.output_tokens","typeLabel":"integer"}},"additionalProperties":false,"type":"object","required":["input_tokens","output_tokens"],"title":"DecisionUsage","isRequired":true,"uniqueKey":"usage","typeLabel":"DecisionUsage · object"}},"additionalProperties":false,"type":"object","required":["model","answers","usage"],"title":"DecisionResponse","example":{"model":"mercury-decide","answers":{"billing":{"type":"noul","noul":0.97},"team":{"type":"choice","choice":"billing","probabilities":{"billing":0.96,"support":0.04},"confidence":0.96},"urgency":{"type":"score","score":1.1,"legend":{"0":"Can wait","1":"Needs attention soon","2":"Needs immediate attention"},"probabilities":{"0":0.1,"1":0.7,"2":0.2},"confidence":0.7}},"usage":{"input_tokens":120,"output_tokens":3}},"uniqueKey":"","typeLabel":"DecisionResponse · object"},"example":{"model":"mercury-decide","answers":{"billing":{"type":"noul","noul":0.97},"team":{"type":"choice","choice":"billing","probabilities":{"billing":0.96,"support":0.04},"confidence":0.96},"urgency":{"type":"score","score":1.1,"legend":{"0":"Can wait","1":"Needs attention soon","2":"Needs immediate attention"},"probabilities":{"0":0.1,"1":0.7,"2":0.2},"confidence":0.7}},"usage":{"input_tokens":120,"output_tokens":3}},"examples":{"Example":{"title":"Example","value":{"model":"mercury-decide","answers":{"billing":{"type":"noul","noul":0.97},"team":{"type":"choice","choice":"billing","probabilities":{"billing":0.96,"support":0.04},"confidence":0.96},"urgency":{"type":"score","score":1.1,"legend":{"0":"Can wait","1":"Needs attention soon","2":"Needs immediate attention"},"probabilities":{"0":0.1,"1":0.7,"2":0.2},"confidence":0.7}},"usage":{"input_tokens":120,"output_tokens":3}}}},"exampleType":"examples"}},"exampleType":"examples"},"0b04d859-7109-4a09-b9f7-bc420de9c035":{"description":"Unauthorized — missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError401","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"message":"Incorrect API key provided","type":"authentication_error","param":null,"code":"invalid_api_key"}},"uniqueKey":"","typeLabel":"DecisionError401 · object"},"example":{"error":{"message":"Incorrect API key provided","type":"authentication_error","param":null,"code":"invalid_api_key"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Incorrect API key provided","type":"authentication_error","param":null,"code":"invalid_api_key"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f010d2ea-20b4-498f-9bee-c99dee356b0d":{"description":"Payment Required — billing inactive or quota exceeded.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError402","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"account_error","type":"invalid_request_error","message":"Account access is unavailable."}},"uniqueKey":"","typeLabel":"DecisionError402 · object"},"example":{"error":{"code":"account_error","type":"invalid_request_error","message":"Account access is unavailable."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"account_error","type":"invalid_request_error","message":"Account access is unavailable."}}}},"exampleType":"examples"}},"exampleType":"examples"},"707ae515-3079-4108-8cfe-3812c57734de":{"description":"Not Found — model not available for this account.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError404","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"model_not_found","type":"invalid_request_error","message":"Decision model not found."}},"uniqueKey":"","typeLabel":"DecisionError404 · object"},"example":{"error":{"code":"model_not_found","type":"invalid_request_error","message":"Decision model not found."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"model_not_found","type":"invalid_request_error","message":"Decision model not found."}}}},"exampleType":"examples"}},"exampleType":"examples"},"c1c1902b-12af-49e6-ba4e-34cf3ceb06cd":{"description":"Payload Too Large — decision request body exceeds the size limit.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError413","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"request_too_large","type":"invalid_request_error","message":"Request body is too large."}},"uniqueKey":"","typeLabel":"DecisionError413 · object"},"example":{"error":{"code":"request_too_large","type":"invalid_request_error","message":"Request body is too large."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"request_too_large","type":"invalid_request_error","message":"Request body is too large."}}}},"exampleType":"examples"}},"exampleType":"examples"},"0ebf03aa-e677-407d-a465-3a057373cec7":{"description":"Unprocessable Entity — invalid decision request.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"HTTPValidationError","required":[],"example":{"detail":[{"loc":["body","questions"],"msg":"Field required","type":"missing"}]},"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"oneOf.0.detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"oneOf.0.detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"oneOf.0.detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"oneOf.0.detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"oneOf.0.detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"oneOf.0.detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"oneOf.0.detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"oneOf.0.detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"oneOf.0.detail","typeLabel":"ValidationError · object[]"}},"uniqueKey":"oneOf.0","typeLabel":"HTTPValidationError · object"},{"type":"object","title":"DecisionUpstreamValidationError","required":["error"],"example":{"error":{"code":"upstream_error","type":"invalid_request_error","message":"Decision service could not complete the request."}},"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"oneOf.1.error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"oneOf.1.error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"oneOf.1.error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"oneOf.1.error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"oneOf.1.error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"ErrorObject · object"}},"uniqueKey":"oneOf.1","typeLabel":"DecisionUpstreamValidationError · object"}],"uniqueKey":"","typeLabel":"HTTPValidationError · object | DecisionUpstreamValidationError · object"},"examples":{"validation":{"title":"validation","summary":"Invalid request","value":{"detail":[{"loc":["body","questions"],"msg":"Field required","type":"missing"}]}},"upstream":{"title":"upstream","summary":"Service validation error","value":{"error":{"code":"upstream_error","type":"invalid_request_error","message":"Decision service could not complete the request."}}}},"exampleType":"examples"}},"exampleType":"examples"},"cc9f0614-4b6e-49b1-ab7f-e34cf037476e":{"description":"Too Many Requests — rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError429","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"rate_limit_exceeded","type":"rate_limit_error","message":"Request or spending limit exceeded."}},"uniqueKey":"","typeLabel":"DecisionError429 · object"},"example":{"error":{"code":"rate_limit_exceeded","type":"rate_limit_error","message":"Request or spending limit exceeded."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limit_exceeded","type":"rate_limit_error","message":"Request or spending limit exceeded."}}}},"exampleType":"examples"}},"exampleType":"examples"},"89904e20-627f-4c56-a197-2d874be6b402":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError500","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"message":"Internal server error","type":"server_error","param":null,"code":"server_error"}},"uniqueKey":"","typeLabel":"DecisionError500 · object"},"example":{"error":{"message":"Internal server error","type":"server_error","param":null,"code":"server_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Internal server error","type":"server_error","param":null,"code":"server_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ebb58ce0-8ace-41c0-a6fc-16f2e02f6153":{"description":"Bad Gateway — invalid response from the decision service.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError502","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service returned an invalid response."}},"uniqueKey":"","typeLabel":"DecisionError502 · object"},"example":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service returned an invalid response."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service returned an invalid response."}}}},"exampleType":"examples"}},"exampleType":"examples"},"34dbeacf-4bb3-4efb-8359-1b4a9c81eab3":{"description":"Service Unavailable — decision service is unavailable.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError503","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service could not complete the request."}},"uniqueKey":"","typeLabel":"DecisionError503 · object"},"example":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service could not complete the request."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","type":"server_error","message":"Decision service could not complete the request."}}}},"exampleType":"examples"}},"exampleType":"examples"},"abcf0c2b-56a7-4be2-97a7-c8d078c47e9a":{"description":"Gateway Timeout — decision service timed out.","content":{"application/json":{"schema":{"type":"object","title":"DecisionError504","required":["error"],"properties":{"error":{"type":"object","title":"ErrorObject","required":["message","type"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Error category, e.g. `invalid_request_error`, `rate_limit_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Offending parameter, if applicable.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Machine-readable error code.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorObject · object"}},"example":{"error":{"code":"upstream_timeout","type":"server_error","message":"Decision service timed out."}},"uniqueKey":"","typeLabel":"DecisionError504 · object"},"example":{"error":{"code":"upstream_timeout","type":"server_error","message":"Decision service timed out."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_timeout","type":"server_error","message":"Decision service timed out."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"38e5e4b5-f49c-4ae4-839f-552c25e1143f":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key provided as a Bearer token: `Authorization: Bearer \u003capi_key>`. Get an API key at https://platform.inceptionlabs.ai.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"05e90beb-3e99-4534-9f7d-e73d81b09d3f":{"url":"https://api.inceptionlabs.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key provided as a Bearer token: `Authorization: Bearer \u003capi_key>`. Get an API key at https://platform.inceptionlabs.ai.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key provided as a Bearer token: `Authorization: Bearer \u003capi_key>`. Get an API key at https://platform.inceptionlabs.ai.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.inceptionlabs.ai/openapi.json"},"subdomain":"inception","siteName":"Inception Platform","title":"Create a decision - Inception Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T10:17:18.531Z","originalFileLocation":"api-reference/decisions/create-a-decision.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=\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported. Images: put chat-style parts such as {\u0026quot;type\u0026quot;: \u0026quot;image_url\u0026quot;, \u0026quot;image_url\u0026quot;: {\u0026quot;url\u0026quot;: \u0026quot;data:image/png;base64,...\u0026quot;}} anywhere in state or a question\u0026#x27;s instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway\u0026#x27;s whole-request body limit (20 MiB by default).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Inception Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_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/inception/CR-PGfA5KwciZhoS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a decision - Inception Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported. Images: put chat-style parts such as {\u0026quot;type\u0026quot;: \u0026quot;image_url\u0026quot;, \u0026quot;image_url\u0026quot;: {\u0026quot;url\u0026quot;: \u0026quot;data:image/png;base64,...\u0026quot;}} anywhere in state or a question\u0026#x27;s instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway\u0026#x27;s whole-request body limit (20 MiB by default).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Inception Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://inception.mintlify.site/_mintlify/api/og/v2?division=Decisions\u0026amp;title=Create+a+decision\u0026amp;description=Evaluate+named+questions+against+a+shared+state+with+Mercury+Decide.+Supports+binary+probability+%28%60noul%60%29%2C+categorical+choice%2C+and+ordinal+score+questions.+Retu\u0026amp;theme=431672c496ba31b1ce25b452\u0026amp;signature=817ca948ccd73690036f39a9b9036be221000b811e300421ddfc57b1e4aff374\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a decision - Inception Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported. Images: put chat-style parts such as {\u0026quot;type\u0026quot;: \u0026quot;image_url\u0026quot;, \u0026quot;image_url\u0026quot;: {\u0026quot;url\u0026quot;: \u0026quot;data:image/png;base64,...\u0026quot;}} anywhere in state or a question\u0026#x27;s instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway\u0026#x27;s whole-request body limit (20 MiB by default).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://inception.mintlify.site/_mintlify/api/og/v2?division=Decisions\u0026amp;title=Create+a+decision\u0026amp;description=Evaluate+named+questions+against+a+shared+state+with+Mercury+Decide.+Supports+binary+probability+%28%60noul%60%29%2C+categorical+choice%2C+and+ordinal+score+questions.+Retu\u0026amp;theme=431672c496ba31b1ce25b452\u0026amp;signature=817ca948ccd73690036f39a9b9036be221000b811e300421ddfc57b1e4aff374\">\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/inception/CR-PGfA5KwciZhoS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Inception Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2C9AF2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/decisions/create-a-decision.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.inceptionlabs.ai/#organization\",\"name\":\"Inception Platform\",\"url\":\"https://docs.inceptionlabs.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/inception/dMlmOrVe7c7dQ19H/logo/light-logo.svg?fit=max\u0026auto=format\u0026n=dMlmOrVe7c7dQ19H\u0026q=85\u0026s=f1e7c8ed94cb5ce8d826b26886a914b3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.inceptionlabs.ai#website\",\"name\":\"Inception Platform\",\"url\":\"https://docs.inceptionlabs.ai\",\"publisher\":{\"@id\":\"https://docs.inceptionlabs.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision#webpage\",\"url\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision\",\"name\":\"Create a decision\",\"description\":\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported. Images: put chat-style parts such as {\\\"type\\\": \\\"image_url\\\", \\\"image_url\\\": {\\\"url\\\": \\\"data:image/png;base64,...\\\"}} anywhere in state or a question's instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway's whole-request body limit (20 MiB by default).\",\"dateModified\":\"2026-10-21T10:17:18.531Z\",\"isPartOf\":{\"@id\":\"https://docs.inceptionlabs.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inception Platform\",\"item\":\"https://docs.inceptionlabs.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a decision\",\"item\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision#apireference\",\"headline\":\"Create a decision\",\"name\":\"Create a decision\",\"description\":\"Evaluate named questions against a shared state with Mercury Decide. Supports binary probability (noul), categorical choice, and ordinal score questions. Returns answers and token usage. Streaming is not supported. Images: put chat-style parts such as {\\\"type\\\": \\\"image_url\\\", \\\"image_url\\\": {\\\"url\\\": \\\"data:image/png;base64,...\\\"}} anywhere in state or a question's instructions (not in criteria). Images must be base64 PNG, JPEG, WebP, or GIF data URLs (remote URLs are not supported), at most 10 MiB each and 16 per upstream request. The complete JSON request, including base64 encoding, is also subject to the gateway's whole-request body limit (20 MiB by default).\",\"url\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision\",\"mainEntityOfPage\":{\"@id\":\"https://docs.inceptionlabs.ai/api-reference/decisions/create-a-decision#webpage\"},\"dateModified\":\"2026-10-21T10:17:18.531Z\",\"publisher\":{\"@id\":\"https://docs.inceptionlabs.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.inceptionlabs.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Inception Platform\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Inception Platform\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/decisions/create-a-decision.md","siteName":"Inception Platform","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Inception Platform","sidebarTitle":"Home","mode":"wide","href":"/index"},{"title":"Quick Start","href":"/get-started"},{"title":"Authentication","href":"/get-started/authentication"},{"title":"Models","mode":"wide","href":"/get-started/models"},{"title":"SDKs","href":"/get-started/sdks"},{"title":"Rate Limits","description":"Per-minute request, input token, and output token rate limits for the Inception API across the Free, Pay As You Go, and Enterprise tiers.","href":"/get-started/rate-limits"}]},{"group":"API reference","pages":[{"group":"Decisions","pages":[{"title":"Create a decision","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/decisions","href":"/api-reference/decisions/create-a-decision"}]},{"group":"Chat","pages":[{"title":"Create a chat completion","description":"Generate a chat completion from a sequence of messages. Returns a `ChatCompletion` object, or a server-sent events stream of `ChatCompletionChunk` deltas when `stream=true`. Supports tool calling, structured output via `response_format`, and reasoning controls.","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/chat/completions","href":"/api-reference/chat/create-a-chat-completion"}]},{"group":"FIM","pages":[{"title":"Create a fill-in-the-middle completion","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/fim/completions","href":"/api-reference/fim/create-a-fill-in-the-middle-completion"}]},{"group":"Edit","pages":[{"title":"Create a code edit completion","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json post /v1/edit/completions","href":"/api-reference/edit/create-a-code-edit-completion"}]},{"group":"Models","pages":[{"title":"List available models","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json get /v1/models","href":"/api-reference/models/list-available-models"},{"title":"List chat models","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json get /v1/chat/completions/models","href":"/api-reference/models/list-chat-models"},{"title":"List FIM models","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json get /v1/fim/completions/models","href":"/api-reference/models/list-fim-models"},{"title":"List Edit models","deprecated":null,"version":null,"openapi":"https://api.inceptionlabs.ai/openapi.json get /v1/edit/completions/models","href":"/api-reference/models/list-edit-models"}]}]},{"group":"Capabilities","pages":[{"title":"Reasoning Efforts","href":"/capabilities/reasoning-efforts"},{"title":"Streaming \u0026 Diffusion","href":"/capabilities/streaming"},{"title":"Tool Use","href":"/capabilities/tool-use"},{"title":"Structured Outputs","href":"/capabilities/structured-outputs"},{"title":"Decisions","href":"/capabilities/decisions"},{"title":"Extract","href":"/capabilities/extract"},{"title":"Autocomplete (FIM)","href":"/capabilities/fim"},{"title":"Next Edit","href":"/capabilities/next-edit"}]},{"group":"Guides","pages":[{"title":"Prompt Guide","icon":"wand-sparkles","href":"/resources/prompt-guide"},{"title":"Voice Quickstart","icon":"microphone","href":"/usecases/voice"},{"group":"Cookbooks","icon":"book-open","pages":[{"title":"Search Agent: Mercury 3 + Web Search","href":"/cookbooks/search-agent-mercury"},{"title":"Voice Customer Support Agent: Mercury 3 + Tool Calling + Voice","href":"/cookbooks/customer-support-agent-mercury"},{"title":"Realtime Voice Assistant: Mercury 3 + ElevenLabs","href":"/cookbooks/realtime-voice-assistant"},{"title":"Natural Language SQL Agent: Mercury 3 + Tool Calling","href":"/cookbooks/natural-language-sql-agent"},{"title":"Coding Agent: Mercury 3 + Tool Calling","href":"/cookbooks/coding-agent-mercury-tool-calling"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Claude Code","href":"/integrations/claude-code"},{"title":"Hermes Agent","href":"/integrations/hermes"},{"title":"Cursor","href":"/integrations/cursor"},{"title":"Zed","href":"/integrations/zed"},{"title":"Kilo Code","href":"/integrations/kilo-code"},{"title":"OpenCode","href":"/integrations/opencode"},{"title":"OpenClaw","href":"/integrations/open-claw"},{"title":"LangChain","href":"/integrations/langchain"},{"title":"ElevenLabs","href":"/integrations/elevenlabs"},{"title":"Vapi","href":"/integrations/vapi"}]}]},{"group":"Resources","pages":[{"title":"Inception Chat","url":"https://chat.inceptionlabs.ai/","href":"/resources/chat"},{"title":"Error Codes","href":"/resources/error-codes"},{"title":"Frequently Asked Questions","sidebarTitle":"FAQ","href":"/resources/faq"}]},{"group":"Support","pages":[{"title":"Mercury API wind-down","sidebarTitle":"Mercury API wind-down","icon":"triangle-exclamation","href":"/support/wind-down"},{"title":"Contact Support","url":"https://platform.inceptionlabs.ai/support","href":"/support/support"},{"title":"Terms of Use","url":"https://www.inceptionlabs.ai/docs/terms-of-use","href":"/support/tou"},{"title":"Privacy Policy","url":"https://www.inceptionlabs.ai/docs/privacy-policy","href":"/support/privacy"}]}]},"basePath":"","title":"Create a decision - Inception Platform","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js"]}