Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/ to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ninetile","colors":{"primary":"#FF744F","light":"#FF916F","dark":"#C73512"},"logo":{"light":"https://ninetile.io/ninetile-docs-logo-light.svg","dark":"https://ninetile.io/ninetile-docs-logo-dark.svg"},"favicon":"https://ninetile.io/icon.svg","api":{"openapi":"https://ninetile.io/openapi.json","playground":{"display":"interactive","proxy":true}},"navbar":{"links":[{"href":"mailto:support@ninetile.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://ninetile.io/dashboard"}},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ninetile","hasAudioNarration":false,"actualSubdomain":"ninetile","customDomains":[],"gitSource":{"type":"artifacts","owner":"prod","repo":"6ae8123bf9f125c812756c7c","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae8126473fa99badecd1d18"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae846b7ba17b289af531d94","collectionId":"7df1c4ce-97d5-4df7-8607-7d7928762cdd","liveDeploymentHistoryId":"6ae846b7ba17b289af531d94","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae85e8a882dd034f026fee3","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Get Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"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/create-solve","slug":"/api-reference/create-solve","pageMetadata":{"title":"Create a solve","openapi":"https://ninetile.io/openapi.json POST /solves","canonical":"https://ninetile.io/docs/api-reference/create-solve","description":"Creates a solve and reserves its price. Without `wait`, the initial response is normally 202. `wait` holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.","href":"/api-reference/create-solve"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates a solve and reserves its price. Without \", _jsx(_components.code, {\n children: \"wait\"\n }), \", the initial response is normally 202. \", _jsx(_components.code, {\n children: \"wait\"\n }), \" holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/\", \" to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\"]\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Create an hCaptcha token solve. A successful solve is charged against your prepaid balance.`})}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 solve","openapi":"https://ninetile.io/openapi.json POST /solves","canonical":"https://ninetile.io/docs/api-reference/create-solve","description":"Creates a solve and reserves its price. Without `wait`, the initial response is normally 202. `wait` holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.","href":"/api-reference/create-solve"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createSolve","tags":["Solves"],"summary":"Create an hCaptcha solve","description":"Creates a solve and reserves its price. Without `wait`, the initial response is normally 202. `wait` holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.","parameters":["e4c2a396-65ec-4112-b456-570d7b1d30e6"],"requestBody":"0af6bc16-1d0d-47cc-9540-f7b6189918e0","responses":{"200":"e970e294-032c-486f-b353-ce9cb7e5bd46","202":"2f052fdc-74a5-4714-a41b-b00aa3c78418","400":"7d79dfcc-30d5-475e-8344-6d9367e9bc6e","401":"51e859ab-a7f5-4706-aa38-e3fca6ad1754","402":"404a4bfc-fa27-405f-a998-76c3b43c04e1","403":"f6932ede-2383-4863-8644-f9f145938e81","413":"f6442a18-5fe2-43de-850c-5e9c6ec15ae1","415":"81e89ebb-aebf-4689-b7c7-9f27a497ba32","422":"c1781791-3f7d-4dd8-b898-2d0afb313a72","429":"8dceda24-2fe0-41c2-8461-759767667efd","500":"33a77ec6-1b1b-486f-bd67-ab6f35db2b32","503":"211449a3-9325-47f7-9a66-ceb25bdb464e"},"method":"post","type":"path","servers":["e7688788-25b1-47d2-bf04-bb9c7bd21e62","76038392-232c-4c70-9d9e-94a788758e78"],"security":["d96127c0-da2c-46ab-b314-8710ccc71eb3","6f4f9b1a-0ed9-4c69-8569-688cdb5c6c2e"],"path":"/solves","baseUrlOptions":["https://api.ninetile.io/v1","https://api.radiumstore.org/v1"],"title":"Create an hCaptcha solve","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e4c2a396-65ec-4112-b456-570d7b1d30e6":{"name":"wait","in":"query","required":false,"description":"Wait this many seconds for a final result (1–90). If omitted, return without waiting.","schema":{"type":"integer","minimum":1,"maximum":90,"isRequired":false,"description":"Wait this many seconds for a final result (1–90). If omitted, return without waiting.","uniqueKey":"","typeLabel":"integer"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","sitekey","url"],"properties":{"type":{"type":"string","enum":["hcaptcha","hcaptcha_enterprise"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"sitekey":{"type":"string","format":"uuid","description":"hCaptcha sitekey UUID.","isRequired":true,"uniqueKey":"sitekey","typeLabel":"string\u003cuuid>"},"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":2048,"description":"HTTP or HTTPS URL of the page containing the challenge.","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"rqdata":{"type":"string","maxLength":16384,"description":"Fresh hCaptcha rqdata, when the page provides one.","uniqueKey":"rqdata","typeLabel":"string"},"user_agent":{"type":"string","maxLength":512,"description":"Accepted but not applied. The solve response provides the user agent to use when submitting the token.","uniqueKey":"user_agent","typeLabel":"string"},"proxy":{"oneOf":[{"type":"string","description":"Optional public HTTP or HTTPS proxy. SOCKS proxies are not supported.","uniqueKey":"proxy.oneOf.0","typeLabel":"string"},{"type":"object","description":"Optional public HTTP or HTTPS proxy. SOCKS proxies are not supported.","required":["host","port"],"properties":{"host":{"type":"string","isRequired":true,"uniqueKey":"proxy.oneOf.1.host","typeLabel":"string"},"port":{"oneOf":[{"type":"integer","maximum":65535,"minimum":1,"isRequired":true,"uniqueKey":"proxy.oneOf.1.port.oneOf.0","typeLabel":"integer"},{"type":"string","pattern":"^[0-9]{1,5}$","isRequired":true,"uniqueKey":"proxy.oneOf.1.port.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"proxy.oneOf.1.port","typeLabel":"integer | string"},"scheme":{"type":"string","enum":["http","https"],"default":"http","uniqueKey":"proxy.oneOf.1.scheme","typeLabel":"enum\u003cstring>"},"username":{"type":"string","uniqueKey":"proxy.oneOf.1.username","typeLabel":"string"},"password":{"type":"string","writeOnly":true,"uniqueKey":"proxy.oneOf.1.password","typeLabel":"string"}},"uniqueKey":"proxy.oneOf.1","typeLabel":"object"}],"uniqueKey":"proxy","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"example":{"type":"hcaptcha","sitekey":"00000000-0000-0000-0000-000000000000","url":"https://target.example/login"},"examples":{"Example":{"title":"Example","value":{"type":"hcaptcha","sitekey":"00000000-0000-0000-0000-000000000000","url":"https://target.example/login"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e970e294-032c-486f-b353-ce9cb7e5bd46":{"description":"Solve reached a final state while waiting.","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["id","object","type","status","sitekey","url","token","user_agent","error","charged_usd","proxy_bytes","created_at","started_at","finished_at","queue_ms","resolve_ms","warnings"],"properties":{"id":{"type":"string","pattern":"^solve_","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"const":"solve","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"type":{"type":"string","enum":["hcaptcha","hcaptcha_enterprise"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","solving","solved","failed","cancelled","expired"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"sitekey":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sitekey","typeLabel":"string\u003cuuid>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"token":{"oneOf":[{"type":"string","description":"hCaptcha response token when the solve succeeds; otherwise null. Token is cleared after 7 days.","isRequired":true,"uniqueKey":"token.oneOf.0","typeLabel":"string"},{"type":"null","description":"hCaptcha response token when the solve succeeds; otherwise null. Token is cleared after 7 days.","isRequired":true,"uniqueKey":"token.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"token","typeLabel":"string | null"},"user_agent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"user_agent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"user_agent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"user_agent","typeLabel":"string | null"},"error":{"oneOf":[{"type":"object","required":["code","message","reason","retryable","docs_url"],"properties":{"code":{"type":"string","description":"Solve failure code.","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.oneOf.0.reason","typeLabel":"string | null"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.oneOf.0.retryable","typeLabel":"boolean"},"docs_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"error.oneOf.0.docs_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"error.oneOf.0.docs_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.oneOf.0.docs_url","typeLabel":"string\u003curi> | null"}},"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"charged_usd":{"oneOf":[{"type":"number","description":"Final charge; null until the solve is final.","isRequired":true,"uniqueKey":"charged_usd.oneOf.0","typeLabel":"number"},{"type":"null","description":"Final charge; null until the solve is final.","isRequired":true,"uniqueKey":"charged_usd.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charged_usd","typeLabel":"number | null"},"proxy_bytes":{"type":"null","description":"Currently always null.","isRequired":true,"uniqueKey":"proxy_bytes","typeLabel":"null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"queue_ms":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"queue_ms.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"queue_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"queue_ms","typeLabel":"integer | null"},"resolve_ms":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"resolve_ms.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"resolve_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"resolve_ms","typeLabel":"integer | null"},"warnings":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["user_agent_not_applied"],"isRequired":true,"uniqueKey":"warnings.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"warnings","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","object":"solve","type":"hcaptcha","status":"pending","sitekey":"3c90c3cc-0d44-4b50-8888-8dd25736052a","url":"\u003cstring>","token":"\u003cstring>","user_agent":"\u003cstring>","error":{"code":"\u003cstring>","message":"\u003cstring>","reason":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>"},"charged_usd":123,"proxy_bytes":null,"created_at":"2023-11-07T05:31:56Z","started_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z","queue_ms":123,"resolve_ms":123,"warnings":[{"code":"user_agent_not_applied","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"2f052fdc-74a5-4714-a41b-b00aa3c78418":{"description":"Solve is pending or solving; poll the solve resource.","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["id","object","type","status","sitekey","url","token","user_agent","error","charged_usd","proxy_bytes","created_at","started_at","finished_at","queue_ms","resolve_ms","warnings"],"properties":{"id":{"type":"string","pattern":"^solve_","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"const":"solve","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"type":{"type":"string","enum":["hcaptcha","hcaptcha_enterprise"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","solving","solved","failed","cancelled","expired"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"sitekey":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sitekey","typeLabel":"string\u003cuuid>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"token":{"oneOf":[{"type":"string","description":"hCaptcha response token when the solve succeeds; otherwise null. Token is cleared after 7 days.","isRequired":true,"uniqueKey":"token.oneOf.0","typeLabel":"string"},{"type":"null","description":"hCaptcha response token when the solve succeeds; otherwise null. Token is cleared after 7 days.","isRequired":true,"uniqueKey":"token.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"token","typeLabel":"string | null"},"user_agent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"user_agent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"user_agent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"user_agent","typeLabel":"string | null"},"error":{"oneOf":[{"type":"object","required":["code","message","reason","retryable","docs_url"],"properties":{"code":{"type":"string","description":"Solve failure code.","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.oneOf.0.reason","typeLabel":"string | null"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.oneOf.0.retryable","typeLabel":"boolean"},"docs_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"error.oneOf.0.docs_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"error.oneOf.0.docs_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.oneOf.0.docs_url","typeLabel":"string\u003curi> | null"}},"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"charged_usd":{"oneOf":[{"type":"number","description":"Final charge; null until the solve is final.","isRequired":true,"uniqueKey":"charged_usd.oneOf.0","typeLabel":"number"},{"type":"null","description":"Final charge; null until the solve is final.","isRequired":true,"uniqueKey":"charged_usd.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"charged_usd","typeLabel":"number | null"},"proxy_bytes":{"type":"null","description":"Currently always null.","isRequired":true,"uniqueKey":"proxy_bytes","typeLabel":"null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"queue_ms":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"queue_ms.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"queue_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"queue_ms","typeLabel":"integer | null"},"resolve_ms":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"resolve_ms.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"resolve_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"resolve_ms","typeLabel":"integer | null"},"warnings":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["user_agent_not_applied"],"isRequired":true,"uniqueKey":"warnings.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"warnings.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"warnings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"warnings","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","object":"solve","type":"hcaptcha","status":"pending","sitekey":"3c90c3cc-0d44-4b50-8888-8dd25736052a","url":"\u003cstring>","token":"\u003cstring>","user_agent":"\u003cstring>","error":{"code":"\u003cstring>","message":"\u003cstring>","reason":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>"},"charged_usd":123,"proxy_bytes":null,"created_at":"2023-11-07T05:31:56Z","started_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z","queue_ms":123,"resolve_ms":123,"warnings":[{"code":"user_agent_not_applied","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7d79dfcc-30d5-475e-8344-6d9367e9bc6e":{"description":"Invalid JSON or a non-object request body (`invalid_request`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"51e859ab-a7f5-4706-aa38-e3fca6ad1754":{"description":"API key missing, malformed, unknown, or revoked (`unauthorized`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying; present when the error asks the client to wait.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"404a4bfc-fa27-405f-a998-76c3b43c04e1":{"description":"Insufficient account balance or key spend limit (`insufficient_credits`, `key_credit_limit_exceeded`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying; present when the error asks the client to wait.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f6932ede-2383-4863-8644-f9f145938e81":{"description":"Account locked or key not permitted to access this endpoint (`account_locked`, `forbidden`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f6442a18-5fe2-43de-850c-5e9c6ec15ae1":{"description":"Request body exceeds 12 MiB or an image exceeds 1.5 MiB (`payload_too_large`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"81e89ebb-aebf-4689-b7c7-9f27a497ba32":{"description":"Request body must use JSON content type (`unsupported_media_type`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c1781791-3f7d-4dd8-b898-2d0afb313a72":{"description":"Field validation error or expired feedback window (`validation_error`, `expired_window`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8dceda24-2fe0-41c2-8461-759767667efd":{"description":"Request, concurrency, sitekey, or authentication-attempt limit reached (`rate_limited`, `concurrency_limit_exceeded`, `rate_capped`, `sitekey_rate_limited`, `proxy_unavailable`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying; present when the error asks the client to wait.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"33a77ec6-1b1b-486f-bd67-ab6f35db2b32":{"description":"Unexpected server error (`internal_error`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"211449a3-9325-47f7-9a66-ceb25bdb464e":{"description":"Solver or recognition service is not ready or at capacity (`maintenance`, `capacity_exhausted`, `proxy_pool_depleted`).","headers":{"X-Request-Id":{"description":"Request identifier for support inquiries.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying; present when the error asks the client to wait.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","param","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","key_credit_limit_exceeded","account_locked","forbidden","not_eligible","not_found","conflict","payload_too_large","unsupported_media_type","expired_window","recognition_failed","validation_error","concurrency_limit_exceeded","proxy_unavailable","rate_capped","rate_limited","sitekey_rate_limited","internal_error","maintenance","capacity_exhausted","proxy_pool_depleted"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"request_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","param":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d96127c0-da2c-46ab-b314-8710ccc71eb3":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Ninetile API key, sent as `Authorization: Bearer \u003ckey>`. Keys are issued in the dashboard.","scopes":[],"schemeName":"BearerAuth"}},"6f4f9b1a-0ed9-4c69-8569-688cdb5c6c2e":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","description":"Alternative to the Authorization Bearer header.","scopes":[],"schemeName":"ApiKeyHeader"}}},"servers":{"e7688788-25b1-47d2-bf04-bb9c7bd21e62":{"url":"https://api.ninetile.io/v1","description":"Primary API"},"76038392-232c-4c70-9d9e-94a788758e78":{"url":"https://api.radiumstore.org/v1","description":"Alternate API host"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Ninetile API key, sent as `Authorization: Bearer \u003ckey>`. Keys are issued in the dashboard.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Ninetile API key, sent as `Authorization: Bearer \u003ckey>`. Keys are issued in the dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Alternative to the Authorization Bearer header.","scopes":[],"schemeName":"ApiKeyHeader"},"schema":{"title":"x-api-key","type":"string","description":"Alternative to the Authorization Bearer header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyHeader","name":"x-api-key"}],"title":"ApiKeyHeader"}]},"originalFileLocation":"https://ninetile.io/openapi.json"},"subdomain":"ninetile","siteName":"Ninetile","title":"Create a solve - Ninetile","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T08:15:54.590Z","originalFileLocation":"api-reference/create-solve.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=\"Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ninetile\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://ninetile.io/icon.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://ninetile.io/icon.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://ninetile.io/icon.svg\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://ninetile.io/icon.svg\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a solve - Ninetile\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ninetile\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://ninetile.io/docs/api-reference/create-solve\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ninetile.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+a+solve\u0026amp;description=Creates+a+solve+and+reserves+its+price.+Without+%60wait%60%2C+the+initial+response+is+normally+202.+%60wait%60+holds+the+request+for+1%E2%80%9390+seconds%3B+a+completed+solve+is+re\u0026amp;theme=d4699c909036f349f9f2ae1d\u0026amp;signature=9d7f8a66c65b2429c49bc916c5c0c81cc3ee2a57fbff2c498c0b6f97b9f9b0bc\">\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 solve - Ninetile\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ninetile.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Create+a+solve\u0026amp;description=Creates+a+solve+and+reserves+its+price.+Without+%60wait%60%2C+the+initial+response+is+normally+202.+%60wait%60+holds+the+request+for+1%E2%80%9390+seconds%3B+a+completed+solve+is+re\u0026amp;theme=d4699c909036f349f9f2ae1d\u0026amp;signature=9d7f8a66c65b2429c49bc916c5c0c81cc3ee2a57fbff2c498c0b6f97b9f9b0bc\">\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/ninetile/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ninetile\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF744F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://ninetile.io/docs/api-reference/create-solve\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/create-solve.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://ninetile.mintlify.dev/#organization\",\"name\":\"Ninetile\",\"url\":\"https://ninetile.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://ninetile.io/ninetile-docs-logo-light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://ninetile.mintlify.dev/docs#website\",\"name\":\"Ninetile\",\"url\":\"https://ninetile.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://ninetile.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://ninetile.io/docs/api-reference/create-solve#webpage\",\"url\":\"https://ninetile.io/docs/api-reference/create-solve\",\"name\":\"Create a solve\",\"description\":\"Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\",\"dateModified\":\"2026-11-02T08:15:54.590Z\",\"isPartOf\":{\"@id\":\"https://ninetile.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://ninetile.io/docs/api-reference/create-solve#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://ninetile.io/docs/api-reference/create-solve#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://ninetile.mintlify.dev/docs/api-reference/status\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a solve\",\"item\":\"https://ninetile.io/docs/api-reference/create-solve\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://ninetile.io/docs/api-reference/create-solve#apireference\",\"headline\":\"Create a solve\",\"name\":\"Create a solve\",\"description\":\"Creates a solve and reserves its price. Without wait, the initial response is normally 202. wait holds the request for 1–90 seconds; a completed solve is returned with 200, otherwise the open solve is returned with 202. Poll GET /solves/{id} to retrieve later results. Successful solves cost $0.00075; unsuccessful solves are not charged.\",\"url\":\"https://ninetile.io/docs/api-reference/create-solve\",\"mainEntityOfPage\":{\"@id\":\"https://ninetile.io/docs/api-reference/create-solve#webpage\"},\"dateModified\":\"2026-11-02T08:15:54.590Z\",\"publisher\":{\"@id\":\"https://ninetile.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://ninetile.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ninetile\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ninetile","nav":{"global":null,"pages":[{"group":"Get Started","pages":[{"title":"Ninetile API","href":"/index"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"API Reference","pages":[{"title":"Service status","openapi":"https://ninetile.io/openapi.json GET /status","description":"Public liveness endpoint; no API key is required.","href":"/api-reference/status"},{"title":"Create a solve","openapi":"https://ninetile.io/openapi.json POST /solves","href":"/api-reference/create-solve"},{"title":"List solves","openapi":"https://ninetile.io/openapi.json GET /solves","description":"Returns solves newest first. Use the last item's `id` as `starting_after` to fetch the next page.","href":"/api-reference/list-solves"},{"title":"Retrieve a solve","openapi":"https://ninetile.io/openapi.json GET /solves/{id}","href":"/api-reference/get-solve"},{"title":"Cancel a solve","openapi":"https://ninetile.io/openapi.json DELETE /solves/{id}","href":"/api-reference/cancel-solve"},{"title":"Report solve feedback","openapi":"https://ninetile.io/openapi.json POST /solves/{id}/feedback","href":"/api-reference/solve-feedback"},{"title":"Report feedback in bulk","openapi":"https://ninetile.io/openapi.json POST /feedback","href":"/api-reference/batch-feedback"},{"title":"Recognize a challenge","openapi":"https://ninetile.io/openapi.json POST /recognize","href":"/api-reference/recognize"},{"title":"Report recognition outcome","openapi":"https://ninetile.io/openapi.json POST /recognize/outcome","href":"/api-reference/recognition-outcome"},{"title":"Get account","openapi":"https://ninetile.io/openapi.json GET /me","href":"/api-reference/account"},{"title":"Get usage","openapi":"https://ninetile.io/openapi.json GET /usage","href":"/api-reference/usage"}]}]},"basePath":"","title":"Create a solve - Ninetile","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}