Short advisory markdown to facilitate navigating this target. Returned even when no configuration reached the target, since knowing what prevented success is useful without a configuration. Not verified against this target. Null when nothing applicable was observed or no notes exist.
How far the workload pass got, when an intent was supplied and a pass ran. A run outcome rather than advice, so it is reported whether or not any guidance could be assembled. Null when no intent was supplied or no pass ran.
Available options:
completed,
turn_limit,
auth_required,
payment_required,
blocked,
error
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Kernel","colors":{"primary":"#212225","light":"#CAB168","dark":"#CAB168"},"logo":{"light":"https://mintcdn.com/tbd-6fc993ce/Lt3m2NlMiCztMtQK/logo/black.svg?fit=max\u0026auto=format\u0026n=Lt3m2NlMiCztMtQK\u0026q=85\u0026s=68e987c751954bbc1d35886a02636c73","dark":"https://mintcdn.com/tbd-6fc993ce/y3CmyOX_b9m5t8tc/logo/white.svg?fit=max\u0026auto=format\u0026n=y3CmyOX_b9m5t8tc\u0026q=85\u0026s=c197f34af93346f9141a9a79870f101e"},"favicon":"https://mintcdn.com/tbd-6fc993ce/G-Oz940pmbilrFx5/favicon.svg?fit=max\u0026auto=format\u0026n=G-Oz940pmbilrFx5\u0026q=85\u0026s=ce38e3ee0e5d07700bccd70f5df08733","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#F0F0F3","dark":"#212225"}},"navbar":{"links":[{"href":"https://dashboard.onkernel.com","label":"Dashboard"},{"href":"https://jobs.ashbyhq.com/usekernel","label":"Careers"}],"primary":{"type":"button","label":"Sign up","href":"https://dashboard.onkernel.com/sign-up"}},"footer":{"socials":{"x":"https://x.com/usekernel","github":"https://github.com/orgs/kernel","linkedin":"https://www.linkedin.com/company/trykernel"}},"seo":{"metatags":{"canonical":"https://www.kernel.sh/docs","og:image":"https://www.kernel.sh/docs/images/og-image.png","twitter:image":"https://www.kernel.sh/docs/images/og-image.png"},"indexing":"all"},"fonts":{"family":"Inter","weight":400},"integrations":{"ga4":{"measurementId":"G-GVEXRLYSN4"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tbd-6fc993ce","hasAudioNarration":false,"actualSubdomain":"tbd-6fc993ce","customDomains":["www.kernel.sh"],"gitSource":{"type":"github","owner":"kernel","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4301f0c59e275effff739","collectionId":"801f3a20-be5f-438c-ae29-21e630e0c574","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4301f0c59e275effff739"},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4af7e5507c0d0db08bc81","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":166},{"language":"default","tag":"Guides","count":91},{"language":"default","tag":"How it works","count":68},{"language":"default","tag":"Configure","count":39},{"language":"default","tag":"MCP","count":31},{"language":"default","tag":"Vaults","count":23},{"language":"default","tag":"Managed Auth","count":15},{"language":"default","tag":"Partnering with KERNEL","count":15},{"language":"default","tag":"CLI","count":15},{"language":"default","tag":"Browser Filesystem","count":15}]},"assistantConfig":{},"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*{text-transform:lowercase!important}.kernel-brand-name{text-transform:uppercase!important}.code-group code,.code-group pre,[class*=highlight] code,[class*=highlight] pre,code,code *,kbd,pre,pre *{text-transform:none!important}*,::after,::before{border-radius:0!important}:root{--btn-selected-bg:#CAB168;--btn-border:#000}#navigation-items .sidebar-group-header{font-weight:300!important;font-size:11px!important}html.dark #navigation-items .sidebar-group-header{color:rgba(237,238,240,.55)!important}#navigation-items div[class*=mt-]>.sidebar-group-header{margin-top:.75rem;padding-top:1rem;border-top:1px solid rgba(33,34,37,.1)}html.dark #navigation-items div[class*=mt-]>.sidebar-group-header{border-top-color:rgba(237,238,240,.1)}#navigation-items li[data-title]>button.group,#navigation-items li[data-title]>div.group{width:100%!important;flex-direction:row-reverse!important;justify-content:space-between!important}#navigation-items li[data-title]>button.group>svg,#navigation-items li[data-title]>div.group>svg{margin-right:0!important;margin-left:0!important}.prose table,article table,table{width:100%!important;border-collapse:separate!important;border-spacing:0!important;border-radius:0!important;overflow:hidden!important;border:1px solid rgb(var(--gray-950)/.1)!important;background-color:#f9fafb!important;margin:0!important;display:table!important}.prose table thead th,article table thead th,table thead th{padding:10px 16px!important;text-align:left!important;font-weight:600!important;font-size:.875rem!important;line-height:1.5rem!important;background-color:rgba(0,0,0,.02)!important;border-bottom:1px solid rgba(0,0,0,.1)!important;word-wrap:break-word!important;word-break:break-word!important;overflow-wrap:break-word!important;white-space:normal!important;max-width:0!important}.prose table tbody tr,article table tbody tr,table tbody tr{transition:background-color .15s ease!important;border-bottom:1px solid rgba(0,0,0,.06)!important}.prose table tbody tr:last-child,article table tbody tr:last-child,table tbody tr:last-child{border-bottom:none!important}.prose table tbody tr:hover,article table tbody tr:hover,table tbody tr:hover{background-color:rgba(0,0,0,.02)!important}.prose table tbody td,article table tbody td,table tbody td{padding:10px 16px!important;font-size:.875rem!important;line-height:1.5rem!important;word-wrap:break-word!important;word-break:break-word!important;overflow-wrap:break-word!important;white-space:normal!important;max-width:0!important;min-width:130px!important}.prose table code,article table code,table code{font-size:.8125rem!important;padding:2px 6px!important;border-radius:0!important}.prose code:not(pre *),article code:not(pre *),code:not(pre *){padding:1px 4px!important;background-color:transparent!important;border:1px solid #d0d2d9!important}html.dark .prose code:not(pre *),html.dark article code:not(pre *),html.dark code:not(pre *){border-color:rgba(237,238,240,.1)!important}.prose table tbody td:first-child,article table tbody td:first-child,table tbody td:first-child{font-weight:500!important}.tinker-box{display:flex;flex-direction:column;gap:32px;padding:32px;border:1px solid rgba(0,0,0,.12);margin-top:2rem;margin-bottom:2rem}.tinker-box-row{display:flex;align-items:center;gap:32px}.tinker-box-content{display:flex;flex-direction:column;gap:32px;flex:1;min-width:0}.copy-prompt-full button,.tinker-box-content button{width:100%!important;max-width:100%!important}@media (max-width:640px){.tinker-box{padding:24px;gap:24px}.tinker-box-row{flex-direction:column;align-items:stretch;gap:24px;width:100%}.tinker-box-content{width:100%}}html.dark .callout[class*=yellow],html.dark .prose table,html.dark article table,html.dark table{border-color:rgba(237,238,240,.1)!important;background-color:rgba(237,238,240,.02)!important}html.dark .prose table thead th,html.dark article table thead th,html.dark table thead th{background-color:rgba(237,238,240,.04)!important;border-bottom-color:rgba(237,238,240,.1)!important}html.dark .prose table tbody tr,html.dark article table tbody tr,html.dark table tbody tr{border-bottom-color:rgba(237,238,240,.08)!important}html.dark .prose table tbody tr:hover,html.dark article table tbody tr:hover,html.dark table tbody tr:hover{background-color:rgba(237,238,240,.04)!important}html.dark .tinker-box{border-color:rgba(237,238,240,.14)}html.dark{--btn-border:#EDEEF0}html.dark .callout[class*=yellow]{background-color:rgba(237,238,240,.03)!important}html.dark .callout[class*=yellow] svg{color:#cab168!important}.dark .card:hover{border-color:rgb(223 223 223)!important}.dark .link{border-bottom-color:#edeef0}#navigation-items img[src*=\"/images/integration-icons/\"]{width:14px;height:14px;opacity:.68}#navigation-items img[src*=\"/images/integration-icons/nousresearch.svg\"]{opacity:.72;transform:scale(1.06)}#navigation-items img[src*=\"/images/integration-icons/browser-use-logo-transparent.svg\"]{transform:scale(.9)}#navigation-items img[src*=\"/images/integration-icons/computer-cursor-rounded.svg\"]{transform:scale(.95)}#navigation-items img[src*=\"/images/integration-icons/laminar-outline.svg\"]{transform:scale(.9)}#navigation-items img[src*=\"/images/integration-icons/stagehand-logo-transparent.svg\"]{transform:scale(.88)}#navigation-items img[src*=\"/images/integration-icons/stripe.svg\"]{transform:scale(.82)}#navigation-items img[src*=\"/images/integration-icons/vercel.svg\"]{transform:scale(.76)}#navigation-items img[src*=\"/images/integration-icons/1password-logo-transparent.svg\"]{opacity:.6;transform:scale(.82)}#navigation-items li>button:has(img[src*=\"/images/integration-icons/\"])>div:has(>svg){order:1}#navigation-items li>button:has(img[src*=\"/images/integration-icons/\"])>div:has(>img[src*=\"/images/integration-icons/\"]){order:3}#navigation-items li>button:has(img[src*=\"/images/integration-icons/\"])>div:not(:has(>svg)):not(:has(>img[src*=\"/images/integration-icons/\"])){order:2}html.dark #navigation-items img[src*=\"/images/integration-icons/\"]{filter:invert(1)}#pagination a[href^=\"/cookbooks/\"]{display:none}#header .eyebrow[data-parent-group]{font-size:0}#header .eyebrow[data-parent-group]::after{content:attr(data-parent-group);font-size:.875rem}.cookbook-tag{display:block;font-size:.6875rem;font-weight:400;letter-spacing:-.015em;opacity:.72;margin-bottom:.5rem}html.dark .cookbook-tag{color:rgba(237,238,240,.7)}html[data-current-path=\"/\"] #header>div.prose{display:none!important}"}],"page":{"pagePath":"api-reference/config-registry/get-a-config-analysis","slug":"/api-reference/config-registry/get-a-config-analysis","pageMetadata":{"title":"Get a config analysis","description":"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /config-registry/analyses/{id}","href":"/api-reference/config-registry/get-a-config-analysis","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\"\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":"Get a config analysis","description":"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /config-registry/analyses/{id}","href":"/api-reference/config-registry/get-a-config-analysis","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tbd-6fc993ce/ab7a5fd22e95880d/conceptual.js","/docs/_mintlify/custom/tbd-6fc993ce/08c6845006936328/eyebrow.js"],"openApiReferenceData":{"operation":{"description":"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.","operationId":"getConfigRegistryAnalysesById","parameters":["ab2e255a-9c5d-4791-8e1a-b820068932c1"],"responses":{"200":"fc7f089a-7203-418f-b88f-0cf155ff1fa8","401":"58546e45-fab1-4b91-a9c2-e1f4ba2b24c0","403":"d0d2a3fa-aa33-4454-b334-1c3aed7a4c9e","404":"d2459e24-fbd4-45c9-a06f-06ffd74c574f","500":"58aa7d33-931c-4602-9155-6cde7c3b1c7a"},"summary":"Get a config analysis","tags":["Config Registry"],"x-cli-skip":true,"method":"get","type":"path","servers":["334ce7c4-2851-4bdf-a5c8-e2a3ff581b12"],"security":["f14fb54d-e4d1-4c73-89ca-ba2afbc74493"],"path":"/config-registry/analyses/{id}","baseUrlOptions":["https://api.onkernel.com"],"title":"Get a config analysis","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ab2e255a-9c5d-4791-8e1a-b820068932c1":{"in":"path","name":"id","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"fc7f089a-7203-418f-b88f-0cf155ff1fa8":{"content":{"application/json":{"schema":{"properties":{"analysis":{"oneOf":[{"type":"object","description":"Pollable analysis after workflow submission is acknowledged. Null when no refresh was submitted.","required":["id","status","failure","created_at","expires_at","finished_at"],"properties":{"created_at":{"description":"Time the analysis was created.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"description":"Deadline after which a still-running analysis becomes expired.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.expires_at","typeLabel":"string\u003cdate-time>"},"failure":{"oneOf":[{"type":"object","description":"Present for failed, canceled, or expired analyses. Messages contain safe retry guidance rather than internal workflow errors.","required":["code","message"],"properties":{"code":{"description":"Application-specific error code (machine-readable)","example":"bad_request","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.failure.oneOf.0.code","typeLabel":"string"},"message":{"description":"Human-readable error description for debugging","example":"Missing required field: app_name","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.failure.oneOf.0.message","typeLabel":"string"},"details":{"description":"Additional error details (for multiple errors)","items":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.details.items.[INDEX].code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.details.items.[INDEX].message","typeLabel":"string"}},"type":"object","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.details","typeLabel":"object[]"},"inner_error":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.inner_error.code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.inner_error.message","typeLabel":"string"}},"type":"object","uniqueKey":"analysis.oneOf.0.failure.oneOf.0.inner_error","typeLabel":"object"}},"isRequired":true,"uniqueKey":"analysis.oneOf.0.failure.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"analysis.oneOf.0.failure.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analysis.oneOf.0.failure","typeLabel":"object | null"},"finished_at":{"oneOf":[{"description":"Time the analysis reached a terminal status. Null while it is running.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Time the analysis reached a terminal status. Null while it is running.","format":"date-time","type":"null","isRequired":true,"uniqueKey":"analysis.oneOf.0.finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analysis.oneOf.0.finished_at","typeLabel":"string\u003cdate-time> | null"},"id":{"description":"Discovery run ID used to poll analysis status.","type":"string","isRequired":true,"uniqueKey":"analysis.oneOf.0.id","typeLabel":"string"},"status":{"description":"Lifecycle status of a background analysis.","enum":["running","completed","failed","canceled","expired"],"type":"string","x-enum-varnames":["ConfigRegistryAnalysisStatusRunning","ConfigRegistryAnalysisStatusCompleted","ConfigRegistryAnalysisStatusFailed","ConfigRegistryAnalysisStatusCanceled","ConfigRegistryAnalysisStatusExpired"],"isRequired":true,"uniqueKey":"analysis.oneOf.0.status","typeLabel":"enum\u003cstring>"},"intent":{"oneOf":[{"description":"The workload description supplied for this analysis. Null when the analysis only tested connectivity.","type":"string","uniqueKey":"analysis.oneOf.0.intent.oneOf.0","typeLabel":"string"},{"description":"The workload description supplied for this analysis. Null when the analysis only tested connectivity.","type":"null","uniqueKey":"analysis.oneOf.0.intent.oneOf.1","typeLabel":"null"}],"uniqueKey":"analysis.oneOf.0.intent","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"analysis.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"analysis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"analysis","typeLabel":"object | null"},"recommendation":{"oneOf":[{"type":"object","description":"Recommendation or structured no-recommendation result for a completed analysis. Null before the analysis produces an outcome.","required":["type","browser","proxy","match_scope","matched_target","evidence"],"properties":{"browser":{"description":"Browser settings that can be passed directly to `POST /browsers`.","properties":{"gpu":{"type":"boolean","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.gpu","typeLabel":"boolean"},"headless":{"type":"boolean","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.headless","typeLabel":"boolean"},"stealth":{"type":"boolean","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.stealth","typeLabel":"boolean"},"viewport":{"description":"Initial browser window size in pixels with optional refresh rate.\nIf omitted, image defaults apply (1920x1080@25).\nFor GPU images, the default is 1920x1080@60.\nArbitrary viewport dimensions and refresh rates are accepted.\nKnown-good presets include:\n2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60.\nFor GPU images, recommended presets use one of these resolutions with refresh rates 60, 30, 25, or 10:\n800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.\nViewports outside this list may exhibit unstable live view or recording behavior.\nIf refresh_rate is not provided, it will be automatically determined based on the resolution\n(higher resolutions use lower refresh rates to keep bandwidth reasonable).\n","properties":{"height":{"description":"Browser window height in pixels. Any positive integer is accepted.","example":800,"minimum":1,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.viewport.height","typeLabel":"integer"},"width":{"description":"Browser window width in pixels. Any positive integer is accepted.","example":1280,"minimum":1,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.viewport.width","typeLabel":"integer"},"refresh_rate":{"description":"Display refresh rate in Hz. Any positive integer is accepted; if omitted, GPU browsers default to 60 and other browsers derive it from width and height.","example":60,"minimum":1,"type":"integer","uniqueKey":"recommendation.oneOf.0.browser.viewport.refresh_rate","typeLabel":"integer"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser.viewport","typeLabel":"object"}},"required":["stealth","headless","gpu","viewport"],"type":"object","isRequired":true,"uniqueKey":"recommendation.oneOf.0.browser","typeLabel":"object"},"evidence":{"properties":{"accessed":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.accessed","typeLabel":"integer"},"blocked":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.blocked","typeLabel":"integer"},"inconclusive":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.inconclusive","typeLabel":"integer"},"last_observed_at":{"description":"Most recent contributing observation. Recommendations remain eligible regardless of age and can be returned while a new analysis refreshes them.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.last_observed_at","typeLabel":"string\u003cdate-time>"},"run_count":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.run_count","typeLabel":"integer"},"sample_size":{"description":"Number of judged trials.","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.sample_size","typeLabel":"integer"},"success_rate":{"description":"Accessed trials divided by judged trials. Inconclusive trials are excluded.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence.success_rate","typeLabel":"number"},"last_supported_at":{"oneOf":[{"description":"Most recent contributing run whose evidence supported recommending this configuration. Omitted when no individual run independently met the recommendation threshold.","format":"date-time","type":"string","uniqueKey":"recommendation.oneOf.0.evidence.last_supported_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Most recent contributing run whose evidence supported recommending this configuration. Omitted when no individual run independently met the recommendation threshold.","format":"date-time","type":"null","uniqueKey":"recommendation.oneOf.0.evidence.last_supported_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"recommendation.oneOf.0.evidence.last_supported_at","typeLabel":"string\u003cdate-time> | null"}},"required":["success_rate","sample_size","accessed","blocked","inconclusive","run_count","last_observed_at"],"type":"object","isRequired":true,"uniqueKey":"recommendation.oneOf.0.evidence","typeLabel":"object"},"match_scope":{"description":"Specificity of knowledge matched for this recommendation. Exact matches use knowledge for the requested target; host and domain matches use broader fallback knowledge.","enum":["exact","host","domain"],"type":"string","x-enum-varnames":["ConfigRegistryRecommendationMatchScopeExact","ConfigRegistryRecommendationMatchScopeHost","ConfigRegistryRecommendationMatchScopeDomain"],"isRequired":true,"uniqueKey":"recommendation.oneOf.0.match_scope","typeLabel":"enum\u003cstring>"},"matched_target":{"description":"Target value that supplied the recommendation.","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.matched_target","typeLabel":"string"},"proxy":{"oneOf":[{"type":"object","description":"Proxy recipe for the recommended browser.","required":["mode"],"properties":{"mode":{"enum":["direct"],"type":"string","x-enum-varnames":["ConfigRegistryDirectProxyModeDirect"],"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.0","typeLabel":"object"},{"type":"object","description":"Proxy recipe for the recommended browser.","required":["mode","create"],"properties":{"create":{"oneOf":[{"type":"object","title":"Custom","description":"Configuration for routing traffic through a proxy.","required":["type","host","port"],"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.port","typeLabel":"integer"},"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.type","typeLabel":"enum\u003cstring>"},"has_ca_bundle":{"description":"Whether the proxy has a custom CA bundle configured.","example":true,"type":"boolean","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.has_ca_bundle","typeLabel":"boolean"},"has_password":{"description":"Whether the proxy has a password.","example":true,"type":"boolean","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.has_password","typeLabel":"boolean"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.username","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.0","typeLabel":"Custom · object"},{"type":"object","title":"Datacenter","description":"Configuration for routing traffic through a proxy.","required":["type"],"deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.type","typeLabel":"enum\u003cstring>"},"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.country","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.1","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.type","typeLabel":"enum\u003cstring>"},"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.country","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.2","typeLabel":"ISP · object"},{"type":"object","title":"Mobile","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.type","typeLabel":"enum\u003cstring>"},"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.state","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Residential","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.type","typeLabel":"enum\u003cstring>"},"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.zip","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create.oneOf.4","typeLabel":"Residential · object"}],"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.create","typeLabel":"Custom · object | Datacenter · object | ISP · object | Mobile · object | Residential · object"},"mode":{"enum":["managed"],"type":"string","x-enum-varnames":["ConfigRegistryManagedProxyModeManaged"],"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"recommendation.oneOf.0.proxy","typeLabel":"object"},"type":{"const":"recommendation","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.0.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"recommendation.oneOf.0","typeLabel":"object"},{"type":"object","description":"Recommendation or structured no-recommendation result for a completed analysis. Null before the analysis produces an outcome.","required":["type","code","message"],"properties":{"code":{"description":"Machine-readable reason Kernel cannot currently provide a config recommendation.\n","enum":["proxy_restricted","target_not_evaluable","no_working_configuration","inconclusive"],"type":"string","x-enum-varnames":["ConfigRegistryNoRecommendationCodeProxyRestricted","ConfigRegistryNoRecommendationCodeTargetNotEvaluable","ConfigRegistryNoRecommendationCodeNoWorkingConfiguration","ConfigRegistryNoRecommendationCodeInconclusive"],"isRequired":true,"uniqueKey":"recommendation.oneOf.1.code","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable explanation suitable for display.","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.1.message","typeLabel":"string"},"type":{"const":"no_recommendation","type":"string","isRequired":true,"uniqueKey":"recommendation.oneOf.1.type","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"recommendation.oneOf.1","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"recommendation.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"recommendation","typeLabel":"object · object · null"},"target":{"properties":{"domain":{"description":"Registrable domain.","type":"string","isRequired":true,"uniqueKey":"target.domain","typeLabel":"string"},"host":{"description":"Full hostname, including subdomain.","type":"string","isRequired":true,"uniqueKey":"target.host","typeLabel":"string"},"normalized":{"description":"Exact normalized scheme, host, port, and path used for lookup.","type":"string","isRequired":true,"uniqueKey":"target.normalized","typeLabel":"string"}},"required":["normalized","host","domain"],"type":"object","isRequired":true,"uniqueKey":"target","typeLabel":"object"},"working_configurations":{"description":"Working configurations for the target, ordered with the recommended configuration first.","items":{"properties":{"browser":{"description":"Browser settings that can be passed directly to `POST /browsers`.","properties":{"gpu":{"type":"boolean","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.gpu","typeLabel":"boolean"},"headless":{"type":"boolean","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.headless","typeLabel":"boolean"},"stealth":{"type":"boolean","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.stealth","typeLabel":"boolean"},"viewport":{"description":"Initial browser window size in pixels with optional refresh rate.\nIf omitted, image defaults apply (1920x1080@25).\nFor GPU images, the default is 1920x1080@60.\nArbitrary viewport dimensions and refresh rates are accepted.\nKnown-good presets include:\n2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60.\nFor GPU images, recommended presets use one of these resolutions with refresh rates 60, 30, 25, or 10:\n800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.\nViewports outside this list may exhibit unstable live view or recording behavior.\nIf refresh_rate is not provided, it will be automatically determined based on the resolution\n(higher resolutions use lower refresh rates to keep bandwidth reasonable).\n","properties":{"height":{"description":"Browser window height in pixels. Any positive integer is accepted.","example":800,"minimum":1,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.viewport.height","typeLabel":"integer"},"width":{"description":"Browser window width in pixels. Any positive integer is accepted.","example":1280,"minimum":1,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.viewport.width","typeLabel":"integer"},"refresh_rate":{"description":"Display refresh rate in Hz. Any positive integer is accepted; if omitted, GPU browsers default to 60 and other browsers derive it from width and height.","example":60,"minimum":1,"type":"integer","uniqueKey":"working_configurations.items.[INDEX].browser.viewport.refresh_rate","typeLabel":"integer"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser.viewport","typeLabel":"object"}},"required":["stealth","headless","gpu","viewport"],"type":"object","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].browser","typeLabel":"object"},"evidence":{"properties":{"accessed":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.accessed","typeLabel":"integer"},"blocked":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.blocked","typeLabel":"integer"},"inconclusive":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.inconclusive","typeLabel":"integer"},"last_observed_at":{"description":"Most recent contributing observation. Recommendations remain eligible regardless of age and can be returned while a new analysis refreshes them.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.last_observed_at","typeLabel":"string\u003cdate-time>"},"run_count":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.run_count","typeLabel":"integer"},"sample_size":{"description":"Number of judged trials.","minimum":0,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.sample_size","typeLabel":"integer"},"success_rate":{"description":"Accessed trials divided by judged trials. Inconclusive trials are excluded.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence.success_rate","typeLabel":"number"},"last_supported_at":{"oneOf":[{"description":"Most recent contributing run whose evidence supported recommending this configuration. Omitted when no individual run independently met the recommendation threshold.","format":"date-time","type":"string","uniqueKey":"working_configurations.items.[INDEX].evidence.last_supported_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"Most recent contributing run whose evidence supported recommending this configuration. Omitted when no individual run independently met the recommendation threshold.","format":"date-time","type":"null","uniqueKey":"working_configurations.items.[INDEX].evidence.last_supported_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"working_configurations.items.[INDEX].evidence.last_supported_at","typeLabel":"string\u003cdate-time> | null"}},"required":["success_rate","sample_size","accessed","blocked","inconclusive","run_count","last_observed_at"],"type":"object","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].evidence","typeLabel":"object"},"match_scope":{"description":"Specificity of knowledge matched for this recommendation. Exact matches use knowledge for the requested target; host and domain matches use broader fallback knowledge.","enum":["exact","host","domain"],"type":"string","x-enum-varnames":["ConfigRegistryRecommendationMatchScopeExact","ConfigRegistryRecommendationMatchScopeHost","ConfigRegistryRecommendationMatchScopeDomain"],"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].match_scope","typeLabel":"enum\u003cstring>"},"matched_target":{"description":"Target value that supplied the recommendation.","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].matched_target","typeLabel":"string"},"proxy":{"oneOf":[{"type":"object","description":"Proxy recipe for the recommended browser.","required":["mode"],"properties":{"mode":{"enum":["direct"],"type":"string","x-enum-varnames":["ConfigRegistryDirectProxyModeDirect"],"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.0","typeLabel":"object"},{"type":"object","description":"Proxy recipe for the recommended browser.","required":["mode","create"],"properties":{"create":{"oneOf":[{"type":"object","title":"Custom","description":"Configuration for routing traffic through a proxy.","required":["type","host","port"],"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.port","typeLabel":"integer"},"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.type","typeLabel":"enum\u003cstring>"},"has_ca_bundle":{"description":"Whether the proxy has a custom CA bundle configured.","example":true,"type":"boolean","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.has_ca_bundle","typeLabel":"boolean"},"has_password":{"description":"Whether the proxy has a password.","example":true,"type":"boolean","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.has_password","typeLabel":"boolean"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.username","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.0","typeLabel":"Custom · object"},{"type":"object","title":"Datacenter","description":"Configuration for routing traffic through a proxy.","required":["type"],"deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.type","typeLabel":"enum\u003cstring>"},"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.country","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.1","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.type","typeLabel":"enum\u003cstring>"},"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.country","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.2","typeLabel":"ISP · object"},{"type":"object","title":"Mobile","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.type","typeLabel":"enum\u003cstring>"},"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.state","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Residential","description":"Configuration for routing traffic through a proxy.","required":["type"],"properties":{"type":{"description":"Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp`. `datacenter` is deprecated; use `isp` instead. Datacenter proxy creation remains supported for backward compatibility.\n","enum":["datacenter","isp","residential","mobile","custom"],"type":"string","x-stainless-override-schema":{"enum":["isp","residential","mobile","custom"],"type":"string"},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.type","typeLabel":"enum\u003cstring>"},"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.zip","typeLabel":"string"},"bypass_hosts":{"description":"Hostnames that should bypass the parent proxy and connect directly.","items":{"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.bypass_hosts.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.bypass_hosts","typeLabel":"string[]"},"config":{"oneOf":[{"type":"object","title":"Datacenter","description":"Configuration specific to the selected proxy `type`.","deprecated":true,"x-deprecated-reason":"Use an ISP proxy instead.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.0","typeLabel":"Datacenter · object"},{"type":"object","title":"ISP","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"country":{"description":"ISO 3166 country code. Supported countries are US, GB, FR, DE, SG, and KR. Defaults to US if not provided.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.1.country","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.1","typeLabel":"ISP · object"},{"type":"object","title":"Residential","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"asn":{"description":"Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html","example":"AS15169","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.asn","typeLabel":"string"},"city":{"description":"City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.","example":"sanfrancisco","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.country","typeLabel":"string"},"os":{"deprecated":true,"description":"Operating system of the residential device.","enum":["windows","macos","android"],"type":"string","x-deprecated-reason":"os selection not supported by proxy provider","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.os","typeLabel":"enum\u003cstring>"},"state":{"description":"Two-letter state code.","example":"CA","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.state","typeLabel":"string"},"zip":{"description":"US ZIP code.","example":"94107","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2.zip","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.2","typeLabel":"Residential · object"},{"type":"object","title":"Mobile","description":"Configuration specific to the selected proxy `type`.","x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"city":{"description":"Provider city alias. Mobile carrier routing can make observed geo vary.","example":"brooklyn","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.3.city","typeLabel":"string"},"country":{"description":"ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting.","example":"US","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.3.country","typeLabel":"string"},"state":{"description":"US-only state code. Mobile carrier routing can make observed geo vary.","example":"NY","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.3.state","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.3","typeLabel":"Mobile · object"},{"type":"object","title":"Custom","description":"Configuration specific to the selected proxy `type`.","required":["host","port"],"x-stainless-override-schema":{"oneOf":[{"$ref":"#/components/schemas/IspProxyConfig"},{"$ref":"#/components/schemas/ResidentialProxyConfig"},{"$ref":"#/components/schemas/MobileProxyConfig"},{"$ref":"#/components/schemas/CreateCustomProxyConfig"}]},"properties":{"host":{"description":"Proxy host address or IP.","example":"127.0.0.1","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4.host","typeLabel":"string"},"port":{"description":"Proxy port.","example":8080,"type":"integer","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4.port","typeLabel":"integer"},"ca_bundle":{"description":"PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates.","example":"-----BEGIN CERTIFICATE-----\nMIIB...\n-----END CERTIFICATE-----\n","maxLength":65536,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4.ca_bundle","typeLabel":"string"},"password":{"description":"Password for proxy authentication.","example":"secret","maxLength":4096,"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4.password","typeLabel":"string"},"username":{"description":"Username for proxy authentication.","example":"user123","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4.username","typeLabel":"string"}},"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config.oneOf.4","typeLabel":"Custom · object"}],"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.config","typeLabel":"Datacenter · object | ISP · object | Residential · object | Mobile · object | Custom · object"},"name":{"description":"Readable name of the proxy.","type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.name","typeLabel":"string"},"protocol":{"default":"https","description":"Protocol to use for the proxy connection.","enum":["http","https"],"type":"string","uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4.protocol","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create.oneOf.4","typeLabel":"Residential · object"}],"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.create","typeLabel":"Custom · object | Datacenter · object | ISP · object | Mobile · object | Residential · object"},"mode":{"enum":["managed"],"type":"string","x-enum-varnames":["ConfigRegistryManagedProxyModeManaged"],"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1.mode","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].proxy","typeLabel":"object"},"type":{"const":"recommendation","type":"string","isRequired":true,"uniqueKey":"working_configurations.items.[INDEX].type","typeLabel":"string"}},"required":["type","browser","proxy","match_scope","matched_target","evidence"],"type":"object","uniqueKey":"working_configurations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"working_configurations","typeLabel":"object[]"},"guidance":{"oneOf":[{"description":"Short advisory markdown to facilitate navigating this target. Returned even when no configuration reached the target, since knowing what prevented success is useful without a configuration. Not verified against this target. Null when nothing applicable was observed or no notes exist.","type":"string","uniqueKey":"guidance.oneOf.0","typeLabel":"string"},{"description":"Short advisory markdown to facilitate navigating this target. Returned even when no configuration reached the target, since knowing what prevented success is useful without a configuration. Not verified against this target. Null when nothing applicable was observed or no notes exist.","type":"null","uniqueKey":"guidance.oneOf.1","typeLabel":"null"}],"uniqueKey":"guidance","typeLabel":"string | null"},"workload_outcome":{"oneOf":[{"description":"How far the workload pass got, when an intent was supplied and a pass ran. A run outcome rather than advice, so it is reported whether or not any guidance could be assembled. Null when no intent was supplied or no pass ran.","enum":["completed","turn_limit","auth_required","payment_required","blocked","error"],"type":"string","uniqueKey":"workload_outcome.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"How far the workload pass got, when an intent was supplied and a pass ran. A run outcome rather than advice, so it is reported whether or not any guidance could be assembled. Null when no intent was supplied or no pass ran.","enum":["completed","turn_limit","auth_required","payment_required","blocked","error"],"type":"null","uniqueKey":"workload_outcome.oneOf.1","typeLabel":"null"}],"uniqueKey":"workload_outcome","typeLabel":"enum\u003cstring> | null"}},"required":["target","analysis","recommendation","working_configurations"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"analysis":{"created_at":"2023-11-07T05:31:56Z","expires_at":"2023-11-07T05:31:56Z","failure":{"code":"bad_request","message":"Missing required field: app_name","details":[{"code":"invalid_input","message":"Provided version string is not semver compliant"}],"inner_error":{"code":"invalid_input","message":"Provided version string is not semver compliant"}},"finished_at":"2023-11-07T05:31:56Z","id":"\u003cstring>","status":"running","intent":"\u003cstring>"},"recommendation":{"browser":{"gpu":true,"headless":true,"stealth":true,"viewport":{"height":800,"width":1280,"refresh_rate":60}},"evidence":{"accessed":1,"blocked":1,"inconclusive":1,"last_observed_at":"2023-11-07T05:31:56Z","run_count":1,"sample_size":1,"success_rate":0.5,"last_supported_at":"2023-11-07T05:31:56Z"},"match_scope":"exact","matched_target":"\u003cstring>","proxy":{"mode":"direct"},"type":"recommendation"},"target":{"domain":"\u003cstring>","host":"\u003cstring>","normalized":"\u003cstring>"},"working_configurations":[{"browser":{"gpu":true,"headless":true,"stealth":true,"viewport":{"height":800,"width":1280,"refresh_rate":60}},"evidence":{"accessed":1,"blocked":1,"inconclusive":1,"last_observed_at":"2023-11-07T05:31:56Z","run_count":1,"sample_size":1,"success_rate":0.5,"last_supported_at":"2023-11-07T05:31:56Z"},"match_scope":"exact","matched_target":"\u003cstring>","proxy":{"mode":"direct"},"type":"recommendation"}],"guidance":"\u003cstring>","workload_outcome":"completed"}}},"exampleType":"generated"}},"description":"Analysis state and the recommendation outcome concluded by that historical run.","exampleType":"generated"},"58546e45-fab1-4b91-a9c2-e1f4ba2b24c0":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Application-specific error code (machine-readable)","example":"bad_request","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"description":"Human-readable error description for debugging","example":"Missing required field: app_name","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (for multiple errors)","items":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"details.items.[INDEX].code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"type":"object","uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details","typeLabel":"object[]"},"inner_error":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"inner_error.code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"inner_error.message","typeLabel":"string"}},"type":"object","uniqueKey":"inner_error","typeLabel":"object"}},"required":["code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"bad_request","message":"Missing required field: app_name","details":[{"code":"invalid_input","message":"Provided version string is not semver compliant"}],"inner_error":{"code":"invalid_input","message":"Provided version string is not semver compliant"}}}},"exampleType":"generated"}},"description":"Unauthorized – missing or invalid authorization token","exampleType":"generated"},"d0d2a3fa-aa33-4454-b334-1c3aed7a4c9e":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Application-specific error code (machine-readable)","example":"bad_request","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"description":"Human-readable error description for debugging","example":"Missing required field: app_name","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (for multiple errors)","items":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"details.items.[INDEX].code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"type":"object","uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details","typeLabel":"object[]"},"inner_error":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"inner_error.code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"inner_error.message","typeLabel":"string"}},"type":"object","uniqueKey":"inner_error","typeLabel":"object"}},"required":["code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"bad_request","message":"Missing required field: app_name","details":[{"code":"invalid_input","message":"Provided version string is not semver compliant"}],"inner_error":{"code":"invalid_input","message":"Provided version string is not semver compliant"}}}},"exampleType":"generated"}},"description":"Forbidden – insufficient permissions or plan","exampleType":"generated"},"d2459e24-fbd4-45c9-a06f-06ffd74c574f":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Application-specific error code (machine-readable)","example":"bad_request","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"description":"Human-readable error description for debugging","example":"Missing required field: app_name","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (for multiple errors)","items":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"details.items.[INDEX].code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"type":"object","uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details","typeLabel":"object[]"},"inner_error":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"inner_error.code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"inner_error.message","typeLabel":"string"}},"type":"object","uniqueKey":"inner_error","typeLabel":"object"}},"required":["code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"bad_request","message":"Missing required field: app_name","details":[{"code":"invalid_input","message":"Provided version string is not semver compliant"}],"inner_error":{"code":"invalid_input","message":"Provided version string is not semver compliant"}}}},"exampleType":"generated"}},"description":"Resource not found","exampleType":"generated"},"58aa7d33-931c-4602-9155-6cde7c3b1c7a":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Application-specific error code (machine-readable)","example":"bad_request","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"description":"Human-readable error description for debugging","example":"Missing required field: app_name","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (for multiple errors)","items":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"details.items.[INDEX].code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"type":"object","uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"details","typeLabel":"object[]"},"inner_error":{"properties":{"code":{"description":"Lower-level error code providing more specific detail","example":"invalid_input","type":"string","uniqueKey":"inner_error.code","typeLabel":"string"},"message":{"description":"Further detail about the error","example":"Provided version string is not semver compliant","type":"string","uniqueKey":"inner_error.message","typeLabel":"string"}},"type":"object","uniqueKey":"inner_error","typeLabel":"object"}},"required":["code","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"bad_request","message":"Missing required field: app_name","details":[{"code":"invalid_input","message":"Provided version string is not semver compliant"}],"inner_error":{"code":"invalid_input","message":"Provided version string is not semver compliant"}}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"f14fb54d-e4d1-4c73-89ca-ba2afbc74493":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"334ce7c4-2851-4bdf-a5c8-e2a3ff581b12":{"description":"API Server","url":"https://api.onkernel.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.onkernel.com/spec.json"},"subdomain":"tbd-6fc993ce","siteName":"Kernel","title":"Get a config analysis - Kernel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T05:50:29.423Z","originalFileLocation":"api-reference/config-registry/get-a-config-analysis.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=\"light\"}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=\"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kernel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_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=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a config analysis - Kernel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kernel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.kernel.sh/docs/images/og-image.png\">\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=\"Get a config analysis - Kernel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.kernel.sh/docs/images/og-image.png\">\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=\"/docs/mintlify-assets/_mintlify/favicons/tbd-6fc993ce/CjCJZGCXnaix-Ex0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kernel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#212225\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis\">\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/config-registry/get-a-config-analysis.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.kernel.sh/#organization\",\"name\":\"Kernel\",\"url\":\"https://www.kernel.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tbd-6fc993ce/Lt3m2NlMiCztMtQK/logo/black.svg?fit=max\u0026auto=format\u0026n=Lt3m2NlMiCztMtQK\u0026q=85\u0026s=68e987c751954bbc1d35886a02636c73\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.kernel.sh/docs#website\",\"name\":\"Kernel\",\"url\":\"https://www.kernel.sh/docs\",\"publisher\":{\"@id\":\"https://www.kernel.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis#webpage\",\"url\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis\",\"name\":\"Get a config analysis\",\"description\":\"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\",\"dateModified\":\"2026-10-30T05:50:29.423Z\",\"isPartOf\":{\"@id\":\"https://www.kernel.sh/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Config Registry\",\"item\":\"https://www.kernel.sh/docs/api-reference/config-registry/list-configs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a config analysis\",\"item\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis#apireference\",\"headline\":\"Get a config analysis\",\"name\":\"Get a config analysis\",\"description\":\"Returns a project-scoped historical analysis and the recommendation outcome concluded by that run. Later knowledge does not change this response.\",\"url\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis\",\"mainEntityOfPage\":{\"@id\":\"https://www.kernel.sh/docs/api-reference/config-registry/get-a-config-analysis#webpage\"},\"image\":\"https://www.kernel.sh/docs/images/og-image.png\",\"dateModified\":\"2026-10-30T05:50:29.423Z\",\"publisher\":{\"@id\":\"https://www.kernel.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://www.kernel.sh/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kernel\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kernel","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Apps","pages":[{"title":"List apps","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /apps","href":"/api-reference/apps/list-apps"}]},{"group":"Audit Logs","pages":[{"title":"List audit logs","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /audit-logs","href":"/api-reference/audit-logs/list-audit-logs"},{"title":"Download an audit-log export chunk","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /audit-logs/export/chunk","href":"/api-reference/audit-logs/download-an-audit-log-export-chunk"},{"title":"List audit log export destinations","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /audit-logs/export/destinations","href":"/api-reference/audit-logs/list-audit-log-export-destinations"},{"title":"Create an audit log export destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /audit-logs/export/destinations","href":"/api-reference/audit-logs/create-an-audit-log-export-destination"},{"title":"Retrieve an audit log export destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /audit-logs/export/destinations/{id}","href":"/api-reference/audit-logs/retrieve-an-audit-log-export-destination"},{"title":"Delete an audit log export destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /audit-logs/export/destinations/{id}","href":"/api-reference/audit-logs/delete-an-audit-log-export-destination"},{"title":"Update an audit log export destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /audit-logs/export/destinations/{id}","href":"/api-reference/audit-logs/update-an-audit-log-export-destination"},{"title":"Test an audit log export destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /audit-logs/export/destinations/{id}/test","href":"/api-reference/audit-logs/test-an-audit-log-export-destination"}]},{"group":"Managed Auth","pages":[{"title":"List auth connections","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /auth/connections","href":"/api-reference/managed-auth/list-auth-connections"},{"title":"Create auth connection","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /auth/connections","href":"/api-reference/managed-auth/create-auth-connection"},{"title":"Get auth connection","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /auth/connections/{id}","href":"/api-reference/managed-auth/get-auth-connection"},{"title":"Delete auth connection","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /auth/connections/{id}","href":"/api-reference/managed-auth/delete-auth-connection"},{"title":"Update auth connection","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /auth/connections/{id}","href":"/api-reference/managed-auth/update-auth-connection"},{"title":"Stream login flow events via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /auth/connections/{id}/events","href":"/api-reference/managed-auth/stream-login-flow-events-via-sse"},{"title":"Start login flow","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /auth/connections/{id}/login","href":"/api-reference/managed-auth/start-login-flow"},{"title":"Submit field values","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /auth/connections/{id}/submit","href":"/api-reference/managed-auth/submit-field-values"},{"title":"Get auth connection event timeline","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /auth/connections/{id}/timeline","href":"/api-reference/managed-auth/get-auth-connection-event-timeline"}]},{"group":"Authentication","pages":[{"title":"Get authentication context","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /auth/context","href":"/api-reference/authentication/get-authentication-context"}]},{"group":"Browser Pools","pages":[{"title":"List browser pools","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browser_pools","href":"/api-reference/browser-pools/list-browser-pools"},{"title":"Create a browser pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browser_pools","href":"/api-reference/browser-pools/create-a-browser-pool"},{"title":"Get browser pool details","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browser_pools/{id_or_name}","href":"/api-reference/browser-pools/get-browser-pool-details"},{"title":"Delete a browser pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /browser_pools/{id_or_name}","href":"/api-reference/browser-pools/delete-a-browser-pool"},{"title":"Update a browser pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /browser_pools/{id_or_name}","href":"/api-reference/browser-pools/update-a-browser-pool"},{"title":"Acquire a browser from the pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browser_pools/{id_or_name}/acquire","href":"/api-reference/browser-pools/acquire-a-browser-from-the-pool"},{"title":"Flush all idle browsers in the pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browser_pools/{id_or_name}/flush","href":"/api-reference/browser-pools/flush-all-idle-browsers-in-the-pool"},{"title":"Release a browser back to the pool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browser_pools/{id_or_name}/release","href":"/api-reference/browser-pools/release-a-browser-back-to-the-pool"}]},{"group":"Browsers","pages":[{"title":"List browser sessions","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers","href":"/api-reference/browsers/list-browser-sessions"},{"title":"Create a browser session","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers","href":"/api-reference/browsers/create-a-browser-session"},{"title":"Get browser session details","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}","href":"/api-reference/browsers/get-browser-session-details"},{"title":"Delete a browser session by ID or name.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /browsers/{id_or_name}","href":"/api-reference/browsers/delete-a-browser-session-by-id-or-name"},{"title":"Update browser session","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /browsers/{id_or_name}","href":"/api-reference/browsers/update-browser-session"},{"title":"Make an HTTP request through the browser's network stack","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/curl","href":"/api-reference/browsers/make-an-http-request-through-the-browsers-network-stack"},{"title":"Ad-hoc upload one or more unpacked extensions to a running browser instance.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/extensions","href":"/api-reference/browsers/ad-hoc-upload-one-or-more-unpacked-extensions-to-a-running-browser-instance"},{"title":"Save the current browser state to a profile","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/profiles","href":"/api-reference/browsers/save-the-current-browser-state-to-a-profile"}]},{"group":"Browser Computer Controls","pages":[{"title":"Execute a batch of computer actions sequentially","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/batch","href":"/api-reference/browser-computer-controls/execute-a-batch-of-computer-actions-sequentially"},{"title":"Simulate a mouse click action on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/click_mouse","href":"/api-reference/browser-computer-controls/simulate-a-mouse-click-action-on-the-browser-instance"},{"title":"Read text from the clipboard on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/clipboard/read","href":"/api-reference/browser-computer-controls/read-text-from-the-clipboard-on-the-browser-instance"},{"title":"Write text to the clipboard on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/clipboard/write","href":"/api-reference/browser-computer-controls/write-text-to-the-clipboard-on-the-browser-instance"},{"title":"Set cursor visibility","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/cursor","href":"/api-reference/browser-computer-controls/set-cursor-visibility"},{"title":"Drag the mouse along a path","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/drag_mouse","href":"/api-reference/browser-computer-controls/drag-the-mouse-along-a-path"},{"title":"Get the current mouse cursor position on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/get_mouse_position","href":"/api-reference/browser-computer-controls/get-the-current-mouse-cursor-position-on-the-browser-instance"},{"title":"Move the mouse cursor to the specified coordinates on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/move_mouse","href":"/api-reference/browser-computer-controls/move-the-mouse-cursor-to-the-specified-coordinates-on-the-browser-instance"},{"title":"Press one or more keys on the host computer","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/press_key","href":"/api-reference/browser-computer-controls/press-one-or-more-keys-on-the-host-computer"},{"title":"Capture a screenshot of the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/screenshot","href":"/api-reference/browser-computer-controls/capture-a-screenshot-of-the-browser-instance"},{"title":"Scroll the mouse wheel at a position on the host computer","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/scroll","href":"/api-reference/browser-computer-controls/scroll-the-mouse-wheel-at-a-position-on-the-host-computer"},{"title":"Type text on the browser instance","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/computer/type","href":"/api-reference/browser-computer-controls/type-text-on-the-browser-instance"}]},{"group":"Browser Filesystem","pages":[{"title":"Create a new directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/create_directory","href":"/api-reference/browser-filesystem/create-a-new-directory"},{"title":"Delete a directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/delete_directory","href":"/api-reference/browser-filesystem/delete-a-directory"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/delete_file","href":"/api-reference/browser-filesystem/delete-a-file"},{"title":"Download a directory as a ZIP archive","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/fs/download_dir_zip","href":"/api-reference/browser-filesystem/download-a-directory-as-a-zip-archive"},{"title":"Get information about a file or directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/fs/file_info","href":"/api-reference/browser-filesystem/get-information-about-a-file-or-directory"},{"title":"List files in a directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/fs/list_files","href":"/api-reference/browser-filesystem/list-files-in-a-directory"},{"title":"Move or rename a file or directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/move","href":"/api-reference/browser-filesystem/move-or-rename-a-file-or-directory"},{"title":"Read file contents","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/fs/read_file","href":"/api-reference/browser-filesystem/read-file-contents"},{"title":"Set file or directory permissions/ownership","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/set_file_permissions","href":"/api-reference/browser-filesystem/set-file-or-directory-permissionsownership"},{"title":"Upload one or more files","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/fs/upload","href":"/api-reference/browser-filesystem/upload-one-or-more-files"},{"title":"Upload a zip archive and extract it","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/fs/upload_zip","href":"/api-reference/browser-filesystem/upload-a-zip-archive-and-extract-it"},{"title":"Watch a directory for changes","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/fs/watch","href":"/api-reference/browser-filesystem/watch-a-directory-for-changes"},{"title":"Stop watching a directory","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /browsers/{id_or_name}/fs/watch/{watch_id}","href":"/api-reference/browser-filesystem/stop-watching-a-directory"},{"title":"Stream filesystem events for a watch","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/fs/watch/{watch_id}/events","href":"/api-reference/browser-filesystem/stream-filesystem-events-for-a-watch"},{"title":"Write or create a file","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /browsers/{id_or_name}/fs/write_file","href":"/api-reference/browser-filesystem/write-or-create-a-file"}]},{"group":"Browser Logs","pages":[{"title":"Stream log files on the browser instance via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/logs/stream","href":"/api-reference/browser-logs/stream-log-files-on-the-browser-instance-via-sse"}]},{"group":"Browser Playwright","pages":[{"title":"Execute Playwright/TypeScript code against the browser","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/playwright/execute","href":"/api-reference/browser-playwright/execute-playwrighttypescript-code-against-the-browser"},{"title":"List Playwright executors","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/playwright/executors","href":"/api-reference/browser-playwright/list-playwright-executors"},{"title":"Delete a Playwright executor","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /browsers/{id_or_name}/playwright/executors/{name}","href":"/api-reference/browser-playwright/delete-a-playwright-executor"}]},{"group":"Browser Processes","pages":[{"title":"Execute a command synchronously","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/process/exec","href":"/api-reference/browser-processes/execute-a-command-synchronously"},{"title":"Execute a command asynchronously","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/process/spawn","href":"/api-reference/browser-processes/execute-a-command-asynchronously"},{"title":"Send signal to process","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/process/{process_id}/kill","href":"/api-reference/browser-processes/send-signal-to-process"},{"title":"Resize a PTY-backed process terminal","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/process/{process_id}/resize","href":"/api-reference/browser-processes/resize-a-pty-backed-process-terminal"},{"title":"Get process status","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/process/{process_id}/status","href":"/api-reference/browser-processes/get-process-status"},{"title":"Write to process stdin","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/process/{process_id}/stdin","href":"/api-reference/browser-processes/write-to-process-stdin"},{"title":"Stream process stdout via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/process/{process_id}/stdout/stream","href":"/api-reference/browser-processes/stream-process-stdout-via-sse"}]},{"group":"Browser REPL","pages":[{"title":"Execute JavaScript in the persistent Browser REPL","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/repl","href":"/api-reference/browser-repl/execute-javascript-in-the-persistent-browser-repl"}]},{"group":"Browser Replays","pages":[{"title":"List browser session replays","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/replays","href":"/api-reference/browser-replays/list-browser-session-replays"},{"title":"Start a browser session replay recording","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/replays","href":"/api-reference/browser-replays/start-a-browser-session-replay-recording"},{"title":"Download a replay recording","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/replays/{replay_id}","href":"/api-reference/browser-replays/download-a-replay-recording"},{"title":"Stop a browser session replay recording","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/replays/{replay_id}/stop","href":"/api-reference/browser-replays/stop-a-browser-session-replay-recording"}]},{"group":"Browser Telemetry","pages":[{"title":"Read telemetry events for a browser session","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/telemetry/events","href":"/api-reference/browser-telemetry/read-telemetry-events-for-a-browser-session"},{"title":"Stream telemetry events via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/telemetry/stream","href":"/api-reference/browser-telemetry/stream-telemetry-events-via-sse"},{"title":"List OTLP destinations","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /telemetry/destinations","href":"/api-reference/browser-telemetry/list-otlp-destinations"},{"title":"Create an OTLP destination","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /telemetry/destinations","href":"/api-reference/browser-telemetry/create-an-otlp-destination"},{"title":"Get OTLP destination by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /telemetry/destinations/{id_or_name}","href":"/api-reference/browser-telemetry/get-otlp-destination-by-id-or-name"},{"title":"Delete OTLP destination by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /telemetry/destinations/{id_or_name}","href":"/api-reference/browser-telemetry/delete-otlp-destination-by-id-or-name"},{"title":"Update OTLP destination by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /telemetry/destinations/{id_or_name}","href":"/api-reference/browser-telemetry/update-otlp-destination-by-id-or-name"}]},{"group":"Browser WebMCP","pages":[{"title":"List custom WebMCP tools","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/webmcp/custom-tools","href":"/api-reference/browser-webmcp/list-custom-webmcp-tools"},{"title":"Add custom WebMCP tools","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/webmcp/custom-tools","href":"/api-reference/browser-webmcp/add-custom-webmcp-tools"},{"title":"Remove a custom WebMCP tool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /browsers/{id_or_name}/webmcp/custom-tools/{id}","href":"/api-reference/browser-webmcp/remove-a-custom-webmcp-tool"},{"title":"Invoke a discovered WebMCP tool","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /browsers/{id_or_name}/webmcp/invoke","href":"/api-reference/browser-webmcp/invoke-a-discovered-webmcp-tool"},{"title":"Discover WebMCP tools across the browser","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /browsers/{id_or_name}/webmcp/tools","href":"/api-reference/browser-webmcp/discover-webmcp-tools-across-the-browser"}]},{"group":"Config Registry","pages":[{"title":"List configs","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /config-registry","href":"/api-reference/config-registry/list-configs"},{"title":"List config analyses","description":"Lists analyses for the selected project, newest first.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /config-registry/analyses","href":"/api-reference/config-registry/list-config-analyses"},{"title":"Get a config analysis","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /config-registry/analyses/{id}","href":"/api-reference/config-registry/get-a-config-analysis"},{"title":"Cancel a config analysis","description":"Requests cancellation of a running project-scoped analysis. Cancellation is asynchronous; poll the analysis until its status becomes canceled. Repeating the request after the analysis reaches a terminal state returns the existing outcome.","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /config-registry/analyses/{id}/cancel","href":"/api-reference/config-registry/cancel-a-config-analysis"},{"title":"Look up a config","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /config-registry/lookup","href":"/api-reference/config-registry/look-up-a-config"},{"title":"Resolve a config","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /config-registry/resolve","href":"/api-reference/config-registry/resolve-a-config"}]},{"group":"Credentials","pages":[]},{"group":"Deployments","pages":[{"title":"List deployments","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /deployments","href":"/api-reference/deployments/list-deployments"},{"title":"Create a deployment","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /deployments","href":"/api-reference/deployments/create-a-deployment"},{"title":"Get deployment details","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /deployments/{id}","href":"/api-reference/deployments/get-deployment-details"},{"title":"Delete a deployment","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /deployments/{id}","href":"/api-reference/deployments/delete-a-deployment"},{"title":"Stream deployment events via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /deployments/{id}/events","href":"/api-reference/deployments/stream-deployment-events-via-sse"}]},{"group":"Extensions","pages":[{"title":"List browser extensions","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /extensions","href":"/api-reference/extensions/list-browser-extensions"},{"title":"Upload a browser extension","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /extensions","href":"/api-reference/extensions/upload-a-browser-extension"},{"title":"Download unpacked extension from Chrome Web Store","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /extensions/from_chrome_store","href":"/api-reference/extensions/download-unpacked-extension-from-chrome-web-store"},{"title":"Download extension archive","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /extensions/{id_or_name}","href":"/api-reference/extensions/download-extension-archive"},{"title":"Delete extension by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /extensions/{id_or_name}","href":"/api-reference/extensions/delete-extension-by-id-or-name"},{"title":"Get extension metadata","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /extensions/{id_or_name}/metadata","href":"/api-reference/extensions/get-extension-metadata"}]},{"group":"Invocations","pages":[{"title":"List invocations","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /invocations","href":"/api-reference/invocations/list-invocations"},{"title":"Invoke an action","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /invocations","href":"/api-reference/invocations/invoke-an-action"},{"title":"Get invocation details","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /invocations/{id}","href":"/api-reference/invocations/get-invocation-details"},{"title":"Update invocation","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /invocations/{id}","href":"/api-reference/invocations/update-invocation"},{"title":"List browsers for an invocation","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /invocations/{id}/browsers","href":"/api-reference/invocations/list-browsers-for-an-invocation"},{"title":"Delete browser sessions for an invocation","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /invocations/{id}/browsers","href":"/api-reference/invocations/delete-browser-sessions-for-an-invocation"},{"title":"Stream invocation events via SSE","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /invocations/{id}/events","href":"/api-reference/invocations/stream-invocation-events-via-sse"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/api_keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /org/api_keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Get an API key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/api_keys/{id}","href":"/api-reference/api-keys/get-an-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /org/api_keys/{id}","href":"/api-reference/api-keys/delete-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /org/api_keys/{id}","href":"/api-reference/api-keys/update-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /org/api_keys/{id}/rotate","href":"/api-reference/api-keys/rotate-an-api-key"}]},{"group":"Credential Providers","pages":[]},{"group":"Organization","pages":[{"title":"Get organization entitlements","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/entitlements","href":"/api-reference/organization/get-organization-entitlements"},{"title":"Get organization limits","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/limits","href":"/api-reference/organization/get-organization-limits"},{"title":"Update organization limits","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /org/limits","href":"/api-reference/organization/update-organization-limits"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/projects","href":"/api-reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /org/projects","href":"/api-reference/projects/create-a-project"},{"title":"Get a project by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/projects/{id_or_name}","href":"/api-reference/projects/get-a-project-by-id-or-name"},{"title":"Delete a project by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /org/projects/{id_or_name}","href":"/api-reference/projects/delete-a-project-by-id-or-name"},{"title":"Update a project by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /org/projects/{id_or_name}","href":"/api-reference/projects/update-a-project-by-id-or-name"},{"title":"Get project limits by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /org/projects/{id_or_name}/limits","href":"/api-reference/projects/get-project-limits-by-id-or-name"},{"title":"Update project limits by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /org/projects/{id_or_name}/limits","href":"/api-reference/projects/update-project-limits-by-id-or-name"},{"title":"List projects","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json get /projects","href":"/api-reference/projects/list-projects-1"},{"title":"Create a project","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json post /projects","href":"/api-reference/projects/create-a-project-1"},{"title":"Get a project by ID or name","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json get /projects/{id_or_name}","href":"/api-reference/projects/get-a-project-by-id-or-name-1"},{"title":"Delete a project by ID or name","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /projects/{id_or_name}","href":"/api-reference/projects/delete-a-project-by-id-or-name-1"},{"title":"Update a project by ID or name","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /projects/{id_or_name}","href":"/api-reference/projects/update-a-project-by-id-or-name-1"},{"title":"Get project limits by ID or name","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json get /projects/{id_or_name}/limits","href":"/api-reference/projects/get-project-limits-by-id-or-name-1"},{"title":"Update project limits by ID or name","deprecated":true,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /projects/{id_or_name}/limits","href":"/api-reference/projects/update-project-limits-by-id-or-name-1"}]},{"group":"Profiles","pages":[{"title":"List profiles","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /profiles","href":"/api-reference/profiles/list-profiles"},{"title":"Create a new profile","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /profiles","href":"/api-reference/profiles/create-a-new-profile"},{"title":"Get profile by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /profiles/{id_or_name}","href":"/api-reference/profiles/get-profile-by-id-or-name"},{"title":"Delete profile by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /profiles/{id_or_name}","href":"/api-reference/profiles/delete-profile-by-id-or-name"},{"title":"Rename profile by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /profiles/{id_or_name}","href":"/api-reference/profiles/rename-profile-by-id-or-name"},{"title":"Download profile archive","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /profiles/{id_or_name}/download","href":"/api-reference/profiles/download-profile-archive"}]},{"group":"Proxies","pages":[{"title":"List proxies","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /proxies","href":"/api-reference/proxies/list-proxies"},{"title":"Create a proxy","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /proxies","href":"/api-reference/proxies/create-a-proxy"},{"title":"Get proxy by ID or name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /proxies/{id_or_name}","href":"/api-reference/proxies/get-proxy-by-id-or-name"},{"title":"Delete proxy by ID","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /proxies/{id_or_name}","href":"/api-reference/proxies/delete-proxy-by-id"},{"title":"Rename proxy by ID","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /proxies/{id_or_name}","href":"/api-reference/proxies/rename-proxy-by-id"},{"title":"Check proxy health","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /proxies/{id_or_name}/check","href":"/api-reference/proxies/check-proxy-health"}]},{"group":"Vaults","pages":[{"title":"List provider configurations in the organization","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vault-provider-configs","href":"/api-reference/vaults/list-provider-configurations-in-the-organization"},{"title":"Register a provider configuration","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /vault-provider-configs","href":"/api-reference/vaults/register-a-provider-configuration"},{"title":"Get a provider configuration","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vault-provider-configs/{id_or_name}","href":"/api-reference/vaults/get-a-provider-configuration"},{"title":"Delete an unused provider configuration","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /vault-provider-configs/{id_or_name}","href":"/api-reference/vaults/delete-an-unused-provider-configuration"},{"title":"Update a provider configuration","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /vault-provider-configs/{id_or_name}","href":"/api-reference/vaults/update-a-provider-configuration"},{"title":"List vaults in the current project","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults","href":"/api-reference/vaults/list-vaults-in-the-current-project"},{"title":"Create or retrieve a vault by immutable name","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /vaults","href":"/api-reference/vaults/create-or-retrieve-a-vault-by-immutable-name"},{"title":"Get a vault","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults/{id_or_name}","href":"/api-reference/vaults/get-a-vault"},{"title":"Delete a vault and invalidate its items","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /vaults/{id_or_name}","href":"/api-reference/vaults/delete-a-vault-and-invalidate-its-items"},{"title":"Get a vault's public key for browser-encrypted credential values","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults/{id_or_name}/encryption_key","href":"/api-reference/vaults/get-a-vaults-public-key-for-browser-encrypted-credential-values"},{"title":"List vault items without secret values","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults/{id_or_name}/items","href":"/api-reference/vaults/list-vault-items-without-secret-values"},{"title":"Get a vault item, its currently available operations, and optionally expanded live data","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults/{id_or_name}/items/{key}","href":"/api-reference/vaults/get-a-vault-item-its-currently-available-operations-and-optionally-expanded-live-data"},{"title":"Create or retrieve an identical vault item by immutable key","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json put /vaults/{id_or_name}/items/{key}","href":"/api-reference/vaults/create-or-retrieve-an-identical-vault-item-by-immutable-key"},{"title":"Delete a vault item and invalidate its secret value","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json delete /vaults/{id_or_name}/items/{key}","href":"/api-reference/vaults/delete-a-vault-item-and-invalidate-its-secret-value"},{"title":"Update a card specification or credential values","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json patch /vaults/{id_or_name}/items/{key}","href":"/api-reference/vaults/update-a-card-specification-or-credential-values"},{"title":"List immutable audit events for a vault item","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json get /vaults/{id_or_name}/items/{key}/events","href":"/api-reference/vaults/list-immutable-audit-events-for-a-vault-item"},{"title":"Perform an operation advertised by a vault item","deprecated":null,"version":null,"openapi":"https://api.onkernel.com/spec.json post /vaults/{id_or_name}/items/{key}/operations","href":"/api-reference/vaults/perform-an-operation-advertised-by-a-vault-item"}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/reference/cli"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/reference/mcp-server"}]},{"tab":"Changelog","href":"https://www.kernel.sh/changelog"}]},"basePath":"","title":"Get a config analysis - Kernel","buildId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","deploymentId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_4Sesi0.js","utils-DRHeK26p.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6d-DUc2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dex7slho.js","snippetPresets-BcCEBp0Z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CufowNTX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-A4lJSCIe.js","shallow-DqoHP7zn.js","getApiPlaygroundDisplay-Cku8AmtL.js","CodeSnippet-CtHQbNqc.js","CodeSnippets-CGo5Cslf.js","Page-BoJxk0m8.js","getPastedJson-M-bKdue4.js","icon-DEqCU4st.js","MethodPill-DnfSSXiJ.js","DuplicateIcon-BHu2PE8M.js","createIcon-BPsE5X7c.js","DynamicMarkdown-Dnt6YhtR.js","SectionHeading-6CtFWqMQ.js","axios-vUo_bRtp.js","Markdown-BoKe_1fI.js","clsx-DM5-sUNJ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CkIdkovK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B3e6Nh_r.js"]}