Date-based contract version, echoed back on the same header. Omit for the default (2026-07); send unstable for the in-development surface. An unrecognized value is rejected with 400 unsupported_api_version.
Where the run has got to. scheduled waits for its due time; starting and provisioning are a container being claimed and built; running is the work happening; stopping is a termination in progress. completed, cancelled and failed are terminal.
Populated only on GET /tasks/{id}. May be a trailing window when steps_limit was given, so read the count from steps_total rather than this array's length.
A task's reported output. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.
Coarse run progress, written by the runtime. Absent on a task that reports none.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pinecone Docs","description":"Official documentation for Pinecone's trusted AI knowledge platform, including Pinecone Database, Pinecone Assistant, and Pinecone Nexus.","colors":{"primary":"#002BFF","light":"#1E86EE","dark":"#002BFF"},"logo":{"light":"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-Black.svg?fit=max\u0026auto=format\u0026n=HsZKO51bNmpAasdT\u0026q=85\u0026s=211d0e7bbefc29ce3b8feee1a05d76ee","dark":"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-White.svg?fit=max\u0026auto=format\u0026n=HsZKO51bNmpAasdT\u0026q=85\u0026s=4839c7a50a8bee830e943705c648297c","href":"https://www.pinecone.io"},"favicon":"https://mintcdn.com/pinecone/9qvQp5nU6duJvusQ/favicon-512.png?fit=max\u0026auto=format\u0026n=9qvQp5nU6duJvusQ\u0026q=85\u0026s=a05db290834f742b6b4b5d30a8d74e90","api":{"openapi":["https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_control_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_evaluation_2026-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-01.alpha/db_control_2026-01.alpha.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-01.alpha/db_data_2026-01.alpha.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_control_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_data_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_evaluation_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/oauth_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/db_control_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/db_data_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/inference_2026-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/admin_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/oauth_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_control_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_data_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_evaluation_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/db_control_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/db_data_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/inference_2025-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/admin_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/oauth_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_control_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_data_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_evaluation_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/db_control_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/db_data_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/inference_2025-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_control_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_data_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_evaluation_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/db_control_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/db_data_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/inference_2025-01.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-10/db_control_2024-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-10/db_data_2024-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-10/inference_2024-10.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-07/control_2024-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-07/data_2024-07.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-04/control_2024-04.oas.yaml","https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2024-04/data_2024-04.oas.yaml"],"playground":{"display":"simple"}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FBFBFC","dark":"#171717"}},"navbar":{"links":[{"href":"/guides/get-started/overview","label":"Docs"},{"href":"https://status.pinecone.io","label":"Status"},{"href":"https://app.pinecone.io/organizations/-/settings/support","label":"Support"},{"href":"https://app.pinecone.io/?sessionType=login","label":"Log in"}],"primary":{"type":"button","label":"Sign up free","href":"https://app.pinecone.io/?sessionType=signup"}},"footer":{"socials":{"x":"https://x.com/pinecone?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor","linkedin":"https://www.linkedin.com/company/pinecone-io","youtube":"https://www.youtube.com/@pinecone-io","github":"https://github.com/pinecone-io"}},"seo":{"metatags":{"og:image":"https://www.pinecone.io/images/docs_og_image_v2.png","twitter:title":"Documentation for the trusted AI knowledge platform | Pinecone","twitter:description":"Guides, API references, and examples for building with Pinecone Database, Pinecone Assistant, and Pinecone Nexus.","twitter:site":"@pinecone","twitter:image":"https://www.pinecone.io/images/docs_og_image_v2.png","google-site-verification":"woTBImNAcYO-gseVfFKIzQrDRUmLWzFjBWrYbYkOTlI"},"indexing":"all"},"integrations":{"gtm":{"tagId":"GTM-5RCSPVG"},"heap":{"appId":"3879495182"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pinecone","hasAudioNarration":false,"actualSubdomain":"pinecone","customDomains":["docs.pinecone.io"],"gitSource":{"type":"github","owner":"pinecone-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae525a8d639100e0f3321cc","collectionId":"74de427c-fc1b-4c4a-8307-d1232ee1e9d0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae525a8d639100e0f3321cc"},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae525a8d639100e0f3321cc","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Pinecone Database","count":551},{"language":"default","tag":"Reference","count":541},{"language":"default","tag":"Database","count":240},{"language":"default","tag":"Admin","count":151},{"language":"default","tag":"Guides","count":133},{"language":"default","tag":"Pinecone Assistant","count":127},{"language":"default","tag":"Pinecone Nexus","count":78},{"language":"default","tag":"Backups","count":70},{"language":"default","tag":"Indexes","count":64},{"language":"default","tag":"Integrations","count":56}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@keyframes shimmer{0%{transform:translateX(-100%)}to{transform:translateX(100%)}}:root{--brand-blue:#002BFF;--primary-main:#002BFF;--primary-dark:#222160;--text-contrast:#FFFFFF;--background:#FBFBFC;--paper:#FFFFFF;--surface:#F2F3F6;--divider:#D8DDDF;--secondary:#72788D;--text-primary:#1C1917;--text-body:#44403C;--text-secondary:#72788D;--border:#e7e5e4}.dark{--brand-blue:#1E86EE;--primary-main:#002BFF;--primary-dark:#222160;--text-contrast:#FFFFFF;--background:#171717;--paper:#1E1E1E;--surface:#252525;--divider:#2A2A2A;--secondary:#72788D;--text-primary:#FFFFFF;--text-body:#D4D4D4;--text-secondary:#A0A0A0;--border:#303030}.dark .dark-inverted{filter:invert(1)}#topbar-cta-button{margin-left:1rem}#topbar-cta-button>a{display:flex;align-items:center;padding:.375rem 1rem!important;gap:.5rem;background-color:var(--brand-blue);color:var(--text-contrast)!important;border-radius:.25rem;font-weight:500;letter-spacing:.4px}#topbar-cta-button a:hover{background-color:var(--primary-dark)!important}.documentation-link{color:var(--brand-blue);text-decoration:none}.documentation-link:hover{color:#000}#navbar{background:var(--background);position:fixed}#navbar-transition{border-bottom:1px solid var(--border)}#navbar .max-w-8xl{max-width:100%}#navbar>div>div>div>div>div>div.flex-1.flex.items-center>a:first-child{min-width:209px}[aria-haspopup=menu]{border-radius:.25rem;border:1px solid var(--border);background-color:transparent!important;color:var(--text-primary)}#navbar nav a{color:var(--text-primary);padding:.6rem 1rem;transition:background-color 250ms cubic-bezier(.4,0,.2,1)}#navbar nav ul li:not(:last-of-type){margin-left:0}#navbar a{margin:0;padding-left:.875rem;padding-right:.875rem}#navbar .nav-tabs{gap:0!important}#navbar div.absolute.bottom-0{display:none}#sidebar{left:0;padding-left:0;background:var(--background);border-right:1px solid var(--border)}#sidebar div.sticky{visibility:hidden}#sidebar-content{padding-left:.5rem}@media (min-width:1024px){:root{--sidebar-width:17.5rem}div:has(>#sidebar){max-width:none;margin-left:0;padding-left:0}#navbar .lg\\:px-12{padding-left:.625rem}#navbar div:has(>.nav-tabs){padding-left:1.5rem}#sidebar-content .sidebar-group a,#sidebar-content .sidebar-group button{padding-block:.3125rem;line-height:1.25rem}#sidebar-content .sidebar-group-header{margin-bottom:.5rem}#navigation-items>div:has(>.sidebar-group-header){margin-top:1.25rem}#content-container>div{justify-content:flex-end}#content-area{max-width:54rem;margin-inline:0;padding-left:3.125rem}div:has(>#sidebar[style*=\"display: none\"]) #content-area{max-width:none}}@media (min-width:1280px){#content-area:has(.sample-app-split){max-width:77.625rem}}#pc-sidebar-toggle{display:none}@media (min-width:1024px){#pc-sidebar-toggle:not([hidden]){position:absolute;z-index:30;top:.5625rem;right:-2rem;display:flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;color:var(--text-secondary);cursor:pointer}#pc-sidebar-toggle:hover{color:var(--text-primary)}#pc-sidebar-toggle:focus-visible{outline:2px solid var(--brand-blue);outline-offset:2px;border-radius:.25rem}#sidebar #navigation-items{position:relative}#sidebar-content>[data-component-part=scroll-area-scrollbar][data-orientation=vertical]{margin-top:4.5rem}#sidebar .nav-dropdown-trigger{width:calc(100% - .75rem)}.pc-sidebar-collapsed #sidebar{width:3rem;overflow:hidden}.pc-sidebar-collapsed #sidebar>*{visibility:hidden}.pc-sidebar-collapsed #pc-sidebar-toggle:not([hidden]){position:fixed;left:1.1875rem;right:auto}}#header h1,#navbar a,#sidebar a,#sidebar li div,#sidebar-content h5,.prose h2,.prose h3,.prose h4{color:var(--text-primary)}#navigation-items .sidebar-group-header{color:var(--text-secondary);font-size:.75rem;font-weight:600;letter-spacing:1px;line-height:160%;text-transform:uppercase}#navigation-items>div+div>.sidebar-group-header{padding-top:1.25rem;border-top:1px solid var(--border)}#navigation-items .sidebar-group-header:has(+.sidebar-group li[data-active=true]){color:var(--text-primary)}#navigation-items .sidebar-group li>button{flex-direction:row-reverse;justify-content:flex-end;column-gap:.375rem;font-weight:500}#navigation-items .sidebar-group li>button>div:last-child{margin-left:-.75rem}#navigation-items .sidebar-group li>button svg{color:var(--text-secondary)}#navigation-items .sidebar-group li>ul,#table-of-contents .toc-item>ul{position:relative}#navigation-items .sidebar-group li>ul::before,#table-of-contents .toc-item>ul::before{content:\"\";position:absolute;top:0;bottom:0;left:1rem;border-left:1px solid var(--border)}#table-of-contents .toc-item>ul::before{left:.25rem}#navigation-items>div>ul>li{margin-left:.75rem}#navigation-items>div>ul>li a.font-semibold{font-weight:400;background-color:var(--surface)}#content-container>div{padding-top:10rem}#content-area>#content:first-child{margin-top:0}@media (min-width:1024px){#content-container>div{gap:3rem}#content-container #table-of-contents{padding-left:0}}#header .eyebrow,.sample-app-heading .eyebrow{text-transform:uppercase;color:var(--text-primary);font-size:.625rem;letter-spacing:1px;line-height:160%}#header .eyebrow:empty{display:none}#header>div:first-of-type>div:nth-of-type(2){margin-top:0}.prose [data-as=p],.prose li,.prose p{color:var(--text-body)}.prose table td,.prose table th{color:var(--text-body)!important}.prose a{color:var(--brand-blue)!important;font-weight:400}.card{box-shadow:none;border:1px solid var(--border)!important;border-radius:.25rem;transition:box-shadow .3s ease;background-color:var(--paper)!important}.card:hover,.example-card:hover{box-shadow:0 5px 5px -3px rgba(163,169,175,.2),0 8px 10px 1px rgba(163,169,175,.14),0 3px 14px 2px rgba(163,169,175,.12)!important}.dark .card:hover,.dark .example-card:hover{box-shadow:none!important}.card>div{padding:1.5rem}.card .integration-title,.card h2,.example-card h2{font-size:1.25rem}.card .integration-title{font-weight:600;line-height:1.5rem;margin-bottom:.833rem;color:var(--text-primary)}.card p,.example-card p,.example-card span[data-as=p]{margin-top:.625rem;font-size:.875rem;color:var(--text-primary)}.card .integration-logo,.card .integration-logo-long{width:3.125rem;height:3.125rem;display:flex;justify-content:center;align-items:center}.card .integration-logo-long{width:5.125rem}.card-grid{display:grid;gap:1.5rem}@media (min-width:640px){.card-grid{grid-template-columns:1fr 1fr}}@media (min-width:1024px){.card-grid{grid-template-columns:1fr 1fr 1fr}}#related-articles,.example-card{display:flex;flex-direction:column}.example-card{box-shadow:none;border:1px solid var(--border);border-radius:.25rem;transition:box-shadow .3s ease;padding:1.5rem;flex-grow:1;background-color:var(--paper)}.example-card .arrow{margin-left:auto;margin-top:auto;opacity:0;transition:opacity .3s ease}.example-card:hover .arrow{opacity:1}.example-card:hover{border:1px solid var(--border)!important}.example-card .tags{display:flex;flex-wrap:wrap;gap:.75rem;margin-top:1.5rem}.example-card .card-tag{border-radius:1rem;background-color:var(--background);color:var(--text-primary);font-size:.8125rem;line-height:138%;letter-spacing:.16px;padding:.1875rem .375rem;display:flex;gap:.375rem;align-items:center}.examples-h2{font-size:1.25rem;margin-bottom:1.5rem}#related-articles{width:100%}#related-articles a,#related-articles h2{color:var(--text-primary);line-height:150%;letter-spacing:.15px}#related-articles h2{font-size:1.25rem;font-weight:600;margin-bottom:1rem}#related-articles a{padding:1.0625rem 0;display:flex;align-items:flex-start;justify-content:space-between;gap:1rem;font-size:.875rem}#related-articles a:not(:last-of-type){border-bottom:1px solid var(--border)}#back-button:hover,#related-articles a:hover{opacity:.7}#back-button>svg,#related-articles a>svg{flex-shrink:0}#back-button{display:flex;gap:.5rem;align-items:center;color:var(--text-primary)!important;font-size:.875rem;margin-bottom:1.5rem}.sample-app-heading{display:flex;flex-direction:column;align-items:center;text-align:center}.sample-app-heading h1,.sample-app-heading p{color:var(--text-primary);margin:.5rem 0 0;font-size:2.125rem;font-weight:600;line-height:123.5%;letter-spacing:.25px}#back-button,.sample-app-heading p{line-height:150%;letter-spacing:.15px}.sample-app-heading p{margin:.5rem 0 1.5rem;font-size:1.25rem}.sample-app-split{display:flex;flex-direction:column;gap:3rem}.sample-app-split .sidebar a:not(.connect-with-pinecone){font-size:.875rem;color:var(--text-primary)!important;border-bottom:none}.sample-app-split .toc-list{display:flex;flex-direction:column;gap:1rem}.sample-app-split .toc-list a.bold{font-weight:700;margin-top:.5rem}.sample-app-split .toc-list a:not(.bold,.connect-with-pinecone){position:relative;padding-left:1rem}.sample-app-split .toc-list a:not(.bold,.connect-with-pinecone)::before{content:\"\";position:absolute;top:0;bottom:0;left:.25rem;border-left:1px solid var(--border)}.sample-app-split .toc-list a:not(.bold,.connect-with-pinecone)+a:not(.bold)::before{top:-1rem}.connect-with-pinecone{border:1px solid var(--border);border-radius:.25rem;padding:.5rem 1rem;display:inline-flex;align-items:center;gap:.5rem;font-size:.875rem;font-weight:500;line-height:1.5rem;letter-spacing:.4px;color:var(--text-primary)!important;text-decoration:none;align-self:flex-start}@media (min-width:1280px){.sample-app-split{flex-direction:row}.sample-app-split :is(.content, .mint-content){overflow-x:auto}.sample-app-split .sidebar{width:20.625rem;flex-shrink:0}}p>code{font-size:.75rem;line-height:150%;letter-spacing:.5px;border-radius:.25rem;padding:.125rem .5rem;background-color:var(--paper)!important;border:0}code .api-key.set{color:orange}.pinecone-connect-connected{width:100%;max-width:31.25rem;background-color:var(--paper);transition:box-shadow 300ms cubic-bezier(.4,0,.2,1) 0ms;border-radius:.25rem;padding:1.5rem;margin:1.5rem 0;border:1px solid var(--border)}.pinecone-connect-connected img{height:1.875rem;margin:0}.pinecone-connect-connected p,p>code{color:var(--text-primary)!important}.pinecone-connect-connected p:last-of-type{margin-top:.75rem}.remove-api-key{display:flex;width:100%;max-width:31.25rem;margin-top:-1.25rem}.remove-api-key>button{font-size:.8125rem;font-weight:500;color:var(--brand-blue);margin-left:auto}.connect-widget-skeleton{margin-block:45px;width:100%;max-width:31.25rem;height:180px;background:var(--paper);border-radius:4px;overflow:hidden;position:relative;border:1px solid var(--border)}.skeleton-content{width:100%;max-width:450px;height:180px;background:linear-gradient(90deg,rgba(255,255,255,0) 0,rgba(255,255,255,.6) 50%,rgba(255,255,255,0) 100%);animation:shimmer 1.5s infinite;position:absolute;top:0;left:0}.not-prose:has(.outlined-button)>span{line-height:1.25}.not-prose:has(.outlined-button)>div{margin-top:.25rem;margin-bottom:0!important}.model-filters{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem;margin:1.5rem 0 .75rem}.model-filter-divider{width:1px;height:1.25rem;margin:0 .25rem;background:var(--divider)}.model-search-wrap{position:relative;display:flex;flex:1 1 10rem;align-items:center;min-width:10rem}.model-search-wrap svg{position:absolute;left:.75rem;color:var(--text-secondary);pointer-events:none}.model-search{width:100%;height:2.25rem;padding:0 .75rem 0 2.5rem;border:1px solid var(--border);border-radius:4px;background:var(--paper);color:var(--text-primary);font-size:.875rem}.model-search::placeholder,.pc-cl-search::placeholder{color:var(--text-secondary)}.model-filter-group{display:inline-flex;height:2.25rem;overflow:hidden;border:1px solid var(--border);border-radius:4px;background:var(--paper)}.model-filter-pill{padding:0 .75rem;color:var(--text-primary);font-size:.875rem;white-space:nowrap;cursor:pointer}.model-filter-pill+.model-filter-pill{border-left:1px solid var(--border)}.model-filter-pill.active{background:var(--brand-blue);color:#fff}.dark .model-filter-pill.active{color:#1c1917}.model-company{position:relative}.model-company-menu button,.model-company-select{color:var(--text-primary);font-size:.875rem;cursor:pointer}.model-company-menu,.model-company-select{border:1px solid var(--border);background:var(--paper)}.model-company-select{display:inline-flex;align-items:center;justify-content:space-between;gap:.5rem;min-width:9.375rem;height:2.25rem;padding:0 .5rem 0 .75rem;border-radius:4px}.model-company-menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:100%;margin:0;padding:0;list-style:none;border-radius:2px;box-shadow:0 10px 15px -3px rgb(0 0 0/.1),0 4px 6px -4px rgb(0 0 0/.1)}.model-company-menu button{width:100%;padding:.5rem;text-align:left;white-space:nowrap}.model-company-menu button:hover{background:var(--surface)}.model-company-menu button.active{font-weight:700}.model-company-select:focus-visible,.model-filter-pill:focus-visible,.model-search:focus{outline:2px solid var(--brand-blue);outline-offset:1px}table.model-table-ready{border:1px solid var(--border);border-radius:6px;border-collapse:separate;border-spacing:0;overflow:hidden;background:var(--paper);font-size:.875rem}.model-table-ready td,.model-table-ready th{min-width:0!important}.model-table-ready thead th{height:3rem;padding:0 1rem!important;background:var(--paper);color:var(--text-secondary);font-size:.875rem;font-weight:600;text-align:left;vertical-align:middle;white-space:nowrap}.model-table-ready thead th a{border-bottom:none!important;color:inherit!important;font-weight:inherit;text-decoration:none}.model-table-ready thead th a::after{content:\"\";display:inline-block;width:.75em;height:.75em;margin-left:.25em;background-color:currentColor;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M4 3h5v5M9 3L3 9'/%3E%3C/svg%3E\") no-repeat center/contain;vertical-align:-.05em}.model-table-ready thead th a:hover{color:var(--brand-blue)!important}.model-table-ready tbody td{padding:1rem!important;border-top:1px solid var(--border);vertical-align:middle}.model-table-ready tbody td code{white-space:nowrap}.model-table-ready tbody tr:hover td{background:rgb(60 114 255/.04)}.model-table-ready tbody td:is(:first-child, :last-child) a{border-bottom:none!important;color:var(--brand-blue);text-decoration:none}.model-table-ready tbody td:last-child a{font-weight:500}.model-table-ready tbody td:is(:first-child, :last-child) a:hover{text-decoration:underline;text-underline-offset:2px}.model-table-ready tbody td:is(:first-child, :nth-child(2), :last-child){white-space:nowrap}.model-table-ready tbody tr.model-table-empty td{text-align:center;color:var(--text-secondary)}.model-table-ready tbody tr.model-table-empty:hover td{background:0 0}html:has(.model-table){overflow-y:scroll}#content-area:has(.model-table) .feedback-toolbar{padding-bottom:0}.model-table-notes{margin-top:1rem;color:var(--text-secondary);font-size:.8125rem}.model-table-notes p,.model-table-notes ul{margin:.25rem 0}.model-table-notes li{margin:.125rem 0}.model-table-notes code{font-size:12px}.model-table-notes a code{padding:0;border:0;background:0 0;color:inherit}.model-logo{display:inline-block;width:18px;height:18px;margin:0 .5rem 0 0!important;border-radius:4px;object-fit:contain;vertical-align:-4px}.model-pill{display:inline-block;padding:2px 10px;border:1px solid rgb(0 0 0/.25);border-radius:9999px;color:var(--text-primary);font-size:.8125rem;line-height:18px;letter-spacing:-.01em;white-space:nowrap}.dark .model-pill{border-color:rgb(255 255 255/.25)}.model-cell-muted{color:var(--text-secondary)}#content-area,#content-container,main{overflow:visible!important}.model-page-tabs>button,.outlined-button{display:flex;align-items:center;font-weight:500}.outlined-button{flex-shrink:0;flex-direction:column;justify-content:center;width:176px;height:40px;padding:4px;border-radius:4px;border:1px solid var(--border);text-decoration:none;font-size:15px;text-align:center;color:var(--text-primary);transition:background-color .3s ease,border .3s ease,color .3s ease}.outlined-button:hover{background-color:var(--paper);border:1px solid var(--brand-blue);color:var(--text-primary)}.model-page-card{padding:1.5rem;border-radius:.25rem;border:1px solid var(--border);background:var(--paper);margin-bottom:2.5rem}.model-page-card-title{display:flex;flex-wrap:wrap;gap:1rem;align-items:center}.model-page-card-title>h1{font-size:1.5rem;color:var(--text-primary)}.model-page-card-logo{width:2.125rem;height:2.125rem;flex-shrink:0}.model-page-card-logo>img{width:100%;height:100%;object-fit:contain}.model-page-card-inference{border-radius:1rem;border:1px solid var(--border);padding:.25rem .375rem .25rem .25rem;display:flex;align-items:center;gap:.375rem;font-size:.8125rem}.model-page-card-stats{display:flex;gap:1.5rem;flex-wrap:wrap;margin-top:1rem}.model-page-card-stats>div>span{font-size:.625rem;color:var(--text-secondary);letter-spacing:.2px;font-weight:500}.model-page-card-stats>div>p,.model-page-card-stats>div>span[data-as=p]{display:block;font-size:.75rem;color:var(--text-primary);letter-spacing:.17px}.model-page-card-stats>div.price{margin-left:auto}.model-page-card-stats>div.price>p{margin-left:auto;font-weight:600}.model-page-tabs{display:flex;width:100%;border-bottom:1px solid var(--border);margin-bottom:2rem}.model-page-tabs>button{padding:.5625rem 1rem;border-bottom:1px solid transparent;color:var(--secondary);gap:.375rem;letter-spacing:.4px}.model-page-tabs>button>svg>path{fill:var(--secondary)}.model-page-tabs>button.active{border-bottom:2px solid var(--brand-blue);color:var(--brand-blue)}.model-page-tabs>button.active>svg>path{fill:var(--brand-blue)}.model-page-guides{display:flex;flex-direction:column;gap:3rem}.model-page-content{flex-shrink:1;width:auto;max-width:1050px}.model-page-content>:first-child{margin-top:0}.model-page-content pre{white-space:pre-wrap}.model-page-sidebar{width:100%;flex-shrink:1}.model-page-sidebar .iframe-placeholder{height:800px}@media (min-width:1080px){.model-page-guides{flex-direction:row}.model-page-content{flex:1 1 auto;min-width:0;max-width:none}.model-page-sidebar{max-width:20.6875rem;flex-shrink:0}}#pinecone-connect-widget iframe{width:100%!important;max-width:500px!important}@media (max-width:576px){#pinecone-connect-widget{scale:.95!important;transform-origin:top left}.connect-widget-skeleton{height:180px;margin-block:30px}.skeleton-content{height:180px}#pinecone-connect-widget,#pinecone-connect-widget iframe,#pinecone-connect-widget>div{width:100%!important;min-width:0!important;max-width:100%!important}div[style*=min-width]{min-width:0!important;width:100%!important}}#page-context-menu-button{border-start-start-radius:.25rem!important;border-end-start-radius:.25rem!important}#page-context-menu button:last-child{border-radius:0!important;border-start-end-radius:.25rem!important;border-end-end-radius:.25rem!important}.agent-tool{border-left:4px solid var(--brand-blue, #002BFF);padding:1rem 1.25rem;border-radius:.375rem;background-color:#f0f4ff;margin:.5rem 0 1rem}.agent-tool>p:first-child{margin-top:0;font-size:.875rem;letter-spacing:.025em}.dark .agent-tool{background-color:rgba(0,43,255,.08);border-left-color:#4d6fff}#changelog-filters{display:none!important}#pc-cl-filters{margin-top:1.5rem;padding-top:1.25rem;border-top:1px solid var(--divider);display:flex;flex-direction:column;gap:.5rem}.pc-cl-heading{margin:0 0 .25rem;font-size:.8125rem;font-weight:600;color:var(--text-primary)}.pc-cl-search{width:100%;padding:.375rem .625rem;font-size:.8125rem;line-height:1.5;color:inherit;background-color:transparent;border:1px solid var(--divider);border-radius:.5rem;appearance:none}.pc-cl-search:focus{outline:0;border-color:var(--brand-blue)}.pc-cl-dd-toggle{width:100%;display:flex;align-items:center;justify-content:space-between;gap:.5rem;padding:.375rem .625rem;font-size:.8125rem;line-height:1.5;text-align:left;color:inherit;cursor:pointer;background-color:transparent;border:1px solid var(--divider);border-radius:.5rem}.pc-cl-dd-menu button:hover,.pc-cl-dd-toggle:hover{background-color:var(--surface)}.pc-cl-dd.is-active .pc-cl-dd-toggle{border-color:var(--brand-blue);font-weight:500}.pc-cl-dd-caret{flex:none;width:.75rem;height:.75rem;opacity:.6}.pc-cl-dd-toggle[aria-expanded=true] .pc-cl-dd-caret{transform:rotate(180deg)}.pc-cl-dd-menu{position:fixed;z-index:50;margin:0;padding:.25rem;overflow-y:auto;list-style:none;background-color:var(--paper);border:1px solid var(--divider);border-radius:.5rem;box-shadow:0 8px 24px rgba(0,0,0,.08)}.dark .pc-cl-dd-menu{box-shadow:0 8px 24px rgba(0,0,0,.4)}.pc-cl-dd-menu li{margin:0;padding:0;list-style:none}.pc-cl-dd-menu li::before,.pc-cl-dd-menu li::marker{content:none;display:none}.pc-cl-clear,.pc-cl-dd-menu button{font-size:.8125rem;cursor:pointer;border:0}.pc-cl-dd-menu button{width:100%;padding:.3125rem .5rem;line-height:1.4;text-align:left;color:inherit;background-color:transparent;border-radius:.375rem}.pc-cl-clear{align-self:flex-start;padding:0;color:var(--brand-blue);background:0 0}.pc-cl-clear:hover{text-decoration:underline}.pc-cl-count{margin:0;font-size:.75rem}.pc-cl-count,.pc-cl-empty{color:var(--text-secondary)}[class*=flex-wrap][class*=gap-2][class*=text-secondary]>span[class*=rounded-lg][class*=font-medium]{padding:.1875rem .625rem;border-radius:9999px;border:1px solid var(--divider);background:0 0}.pc-mermaid-action rect{fill:var(--brand-blue)!important;stroke:var(--brand-blue)!important}.pc-mermaid-action .nodeLabel,.pc-mermaid-action .nodeLabel *{color:var(--text-contrast)!important}.cluster.pc-mermaid-group rect,.pc-mermaid-item rect{fill:transparent!important;stroke:var(--brand-blue)!important}.cluster.pc-mermaid-frame rect{fill:transparent!important;stroke:var(--secondary)!important}"}],"page":{"pagePath":"api-reference/tasks/get-a-task-with-steps","slug":"/api-reference/tasks/get-a-task-with-steps","pageMetadata":{"title":"Get a task (with steps)","description":"Unlike the listing, this carries the task's `steps` — every one by default, or the newest N with `steps_limit`, where `steps_total` reports the true count.","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}","href":"/api-reference/tasks/get-a-task-with-steps","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Unlike the listing, this carries the task’s \", _jsx(_components.code, {\n children: \"steps\"\n }), \" — every one by default, or the newest N with \", _jsx(_components.code, {\n children: \"steps_limit\"\n }), \", where \", _jsx(_components.code, {\n children: \"steps_total\"\n }), \" reports the true count.\"]\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 task (with steps)","description":"Unlike the listing, this carries the task's `steps` — every one by default, or the newest N with `steps_limit`, where `steps_total` reports the true count.","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}","href":"/api-reference/tasks/get-a-task-with-steps","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/pinecone/345ae6b85c58f0d4/console-iframe.js","/_mintlify/custom/pinecone/7865d5d28c64c1ee/script.js","/_mintlify/custom/pinecone/4d30bdf131035051/inkeep.js"],"openApiReferenceData":{"operation":{"tags":["Tasks"],"summary":"Get a task (with steps)","description":"Unlike the listing, this carries the task's `steps` — every one by default, or the newest N with `steps_limit`, where `steps_total` reports the true count.","operationId":"get_task","parameters":["7f1070ff-278d-4816-883d-27707a5e46d4","8b7c556b-6264-45f6-b49c-4b6608f7d66c","db15d8ec-af7e-42f5-a166-f6e7e10a8030"],"responses":{"200":"bb0b2a45-d767-4e64-b436-9eb09011bbd6","404":"99b9ed51-9b93-4eba-9e53-dd6678108b50"},"method":"get","type":"path","servers":["05a65f99-f0f5-4cc6-bfe4-7306774cd220"],"security":["35448661-e633-4a7f-a97e-2147e7209c4f","1698663c-2d06-4827-adad-c1bb4f6c0e85"],"path":"/tasks/{id}","baseUrlOptions":["https://{host}/api"],"title":"Get a task (with steps)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7f1070ff-278d-4816-883d-27707a5e46d4":{"in":"path","name":"id","description":"Task id.","required":true,"schema":{"type":"string","isRequired":true,"description":"Task id.","uniqueKey":"","typeLabel":"string"},"style":"simple"},"8b7c556b-6264-45f6-b49c-4b6608f7d66c":{"in":"header","name":"X-Pinecone-Api-Version","description":"Date-based contract version, echoed back on the same header. Omit for the default (`2026-07`); send `unstable` for the in-development surface. An unrecognized value is rejected with `400 unsupported_api_version`.","schema":{"default":"2026-07","x-enum":["2026-07","unstable"],"type":"string","description":"Date-based contract version, echoed back on the same header. Omit for the default (`2026-07`); send `unstable` for the in-development surface. An unrecognized value is rejected with `400 unsupported_api_version`.","uniqueKey":"","typeLabel":"string"},"style":"simple"},"db15d8ec-af7e-42f5-a166-f6e7e10a8030":{"in":"query","name":"steps_limit","description":"Return only this many trailing steps. Absent returns them all.","schema":{"type":"integer","minimum":0,"description":"Return only this many trailing steps. Absent returns them all.","uniqueKey":"","typeLabel":"integer"},"style":"form"}},"responses":{"bb0b2a45-d767-4e64-b436-9eb09011bbd6":{"description":"The task","content":{"application/json":{"schema":{"description":"One task record — a single run of a workflow, owned by the project.","type":"object","properties":{"id":{"description":"Task id.","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"project_id":{"description":"The Pinecone project that owns the task.","type":"string","isRequired":true,"uniqueKey":"project_id","typeLabel":"string"},"created_by":{"description":"Principal that started the run.","type":"string","isRequired":true,"uniqueKey":"created_by","typeLabel":"string"},"workflow":{"description":"The canonical workflow name.","x-enum":["optimize","curate","search","search_cc","search_rag","work","explore","profile","import","pack","restore","groom"],"type":"string","isRequired":true,"uniqueKey":"workflow","typeLabel":"string"},"state":{"description":"Where the run has got to. `scheduled` waits for its due time; `starting` and `provisioning` are a container being claimed and built; `running` is the work happening; `stopping` is a termination in progress. `completed`, `cancelled` and `failed` are terminal.","x-enum":["scheduled","starting","provisioning","running","stopping","completed","cancelled","failed"],"type":"string","isRequired":true,"uniqueKey":"state","typeLabel":"string"},"input":{"oneOf":[{"type":"object","title":"Search / search_cc / search_rag / work","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["session_id","query_id","ask","messages","models","tools","shape","instructions","scope","turn_timeout_seconds","comparison_group"],"properties":{"session_id":{"description":"The session the turn runs in.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.session_id","typeLabel":"string"},"query_id":{"description":"The turn this task serves.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.query_id","typeLabel":"string"},"ask":{"description":"Title fallback for the tasks UI; empty when the turn had no user message","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.ask","typeLabel":"string"},"messages":{"description":"The conversation history handed to the runtime.","type":"array","items":{"description":"One message of history.","type":"object","properties":{"role":{"description":"Who sent it, e.g. `user`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.messages.items.[INDEX].role","typeLabel":"string"},"content":{"description":"The message text.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.messages.items.[INDEX].content","typeLabel":"string"}},"required":["role","content"],"uniqueKey":"input.oneOf.0.messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"input.oneOf.0.messages","typeLabel":"object[]"},"models":{"description":"The session's model fallback list, in preference order.","type":"array","items":{"description":"A catalog model id or tier name.","type":"string","uniqueKey":"input.oneOf.0.models.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"input.oneOf.0.models","typeLabel":"string[]"},"tools":{"description":"Tool names the turn may call.","type":"array","items":{"description":"A tool name.","type":"string","uniqueKey":"input.oneOf.0.tools.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"input.oneOf.0.tools","typeLabel":"string[]"},"shape":{"oneOf":[{"description":"JSON Schema the answer must conform to. Null on a free-text turn.","type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"input.oneOf.0.shape.oneOf.0","typeLabel":"object"},{"description":"JSON Schema the answer must conform to. Null on a free-text turn.","type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"input.oneOf.0.shape.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.shape","typeLabel":"object | null"},"instructions":{"oneOf":[{"description":"The session's system prompt. Null when none was pinned.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.instructions.oneOf.0","typeLabel":"string"},{"description":"The session's system prompt. Null when none was pinned.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.instructions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.instructions","typeLabel":"string | null"},"scope":{"description":"Context ids the turn searches.","type":"array","items":{"description":"A context id the turn searched.","type":"string","uniqueKey":"input.oneOf.0.scope.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"input.oneOf.0.scope","typeLabel":"string[]"},"turn_timeout_seconds":{"description":"Runtime budget for this one turn.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.turn_timeout_seconds","typeLabel":"integer\u003cint64>"},"comparison_group":{"oneOf":[{"description":"The Compare run this turn belongs to. Null on a normal single query.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.comparison_group.oneOf.0","typeLabel":"string"},{"description":"The Compare run this turn belongs to. Null on a normal single query.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.comparison_group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.comparison_group","typeLabel":"string | null"},"retrieval":{"description":"The turn's retrieval controls.","type":"object","properties":{"retrieval_only":{"oneOf":[{"description":"Skip synthesis and return the hits. Null where the caller omitted it.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.retrieval_only.oneOf.0","typeLabel":"boolean"},{"description":"Skip synthesis and return the hits. Null where the caller omitted it.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.retrieval_only.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.retrieval_only","typeLabel":"boolean | null"},"pointers_only":{"oneOf":[{"description":"Skip synthesis and return pointers only. Null where the caller omitted it.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.pointers_only.oneOf.0","typeLabel":"boolean"},{"description":"Skip synthesis and return pointers only. Null where the caller omitted it.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.pointers_only.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.pointers_only","typeLabel":"boolean | null"},"chunks_only":{"oneOf":[{"description":"Narrow retrieval to chunks. Null where the caller omitted it.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.chunks_only.oneOf.0","typeLabel":"boolean"},{"description":"Narrow retrieval to chunks. Null where the caller omitted it.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.chunks_only.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.chunks_only","typeLabel":"boolean | null"},"artifacts_only":{"oneOf":[{"description":"Narrow retrieval to artifacts. Null where the caller omitted it.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.artifacts_only.oneOf.0","typeLabel":"boolean"},{"description":"Narrow retrieval to artifacts. Null where the caller omitted it.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.artifacts_only.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.artifacts_only","typeLabel":"boolean | null"},"max_retrieved":{"oneOf":[{"description":"Cap on retrieved items. Null where the caller omitted it.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Cap on retrieved items. Null where the caller omitted it.","type":"null","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved","typeLabel":"integer\u003cint64> | null"},"max_retrieved_chars":{"oneOf":[{"description":"Cap on per-item text length. Null where the caller omitted it.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved_chars.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Cap on per-item text length. Null where the caller omitted it.","type":"null","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved_chars.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_retrieved_chars","typeLabel":"integer\u003cint64> | null"},"compose":{"oneOf":[{"description":"Whether to synthesize an answer. Null where the caller omitted it.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.compose.oneOf.0","typeLabel":"boolean"},{"description":"Whether to synthesize an answer. Null where the caller omitted it.","type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.compose.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.compose","typeLabel":"boolean | null"},"max_steps":{"oneOf":[{"description":"Cap on the agent's tool-loop steps. Null where the caller omitted it.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_steps.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Cap on the agent's tool-loop steps. Null where the caller omitted it.","type":"null","format":"int64","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_steps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.max_steps","typeLabel":"integer\u003cint64> | null"},"thinking_level":{"oneOf":[{"description":"Reasoning depth. Null where the caller omitted it.","x-enum":["minimal","low","medium","high"],"type":"string","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.thinking_level.oneOf.0","typeLabel":"string"},{"description":"Reasoning depth. Null where the caller omitted it.","x-enum":["minimal","low","medium","high"],"type":"null","isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.thinking_level.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"input.oneOf.0.retrieval.thinking_level","typeLabel":"string | null"}},"required":["retrieval_only","pointers_only","chunks_only","artifacts_only","max_retrieved","max_retrieved_chars","compose","max_steps","thinking_level"],"uniqueKey":"input.oneOf.0.retrieval","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.0","typeLabel":"Search / search_cc / search_rag / work · object"},{"type":"object","title":"Curate","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["trigger","force","scope"],"properties":{"trigger":{"description":"What started the run, e.g. `manual`, `reconcile`, `restore`, or `resume`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.1.trigger","typeLabel":"string"},"force":{"description":"Full rebuild rather than incremental.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.1.force","typeLabel":"boolean"},"scope":{"description":"What the run covered, e.g. `full`, `reconcile`, or `restore`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.1.scope","typeLabel":"string"},"batch_size":{"description":"Sources processed per batch.","type":"integer","uniqueKey":"input.oneOf.1.batch_size","typeLabel":"integer"},"models":{"description":"Model-id overrides for the curate runtime.","type":"array","items":{"description":"A catalog model id or tier name.","type":"string","uniqueKey":"input.oneOf.1.models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.1.models","typeLabel":"string[]"},"legs":{"description":"Set to `[\"chunks\"]` to gate the run to the chunk + keyword indices, skipping artifact extraction.","type":"array","items":{"description":"A leg name, e.g. `chunks`.","type":"string","uniqueKey":"input.oneOf.1.legs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.1.legs","typeLabel":"string[]"},"artifacts_reset":{"description":"Drop the existing artifacts and re-extract from scratch.","type":"boolean","uniqueKey":"input.oneOf.1.artifacts_reset","typeLabel":"boolean"},"skip_corpus_aggregation":{"description":"Skip the corpus-wide artifact pass, leaving only per-document extraction.","type":"boolean","uniqueKey":"input.oneOf.1.skip_corpus_aggregation","typeLabel":"boolean"},"claimed_version":{"description":"What a drained predecessor had already reserved.","type":"integer","format":"int64","uniqueKey":"input.oneOf.1.claimed_version","typeLabel":"integer\u003cint64>"}},"isRequired":true,"uniqueKey":"input.oneOf.1","typeLabel":"Curate · object"},{"type":"object","title":"Connector import","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["provider","connector_id","item_type","files","path"],"properties":{"provider":{"description":"The connector's provider, e.g. `box`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.2.provider","typeLabel":"string"},"connector_id":{"description":"The linked connector the sources came from.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.2.connector_id","typeLabel":"string"},"item_type":{"description":"Whether `folder` or `files` selected the sources.","x-enum":["folder","file"],"type":"string","isRequired":true,"uniqueKey":"input.oneOf.2.item_type","typeLabel":"string"},"files":{"description":"Connector file ids imported. Empty on a folder import.","type":"array","items":{"description":"A connector file id.","type":"string","uniqueKey":"input.oneOf.2.files.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"input.oneOf.2.files","typeLabel":"string[]"},"path":{"description":"Subdirectory under the source tree the import landed in.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.2.path","typeLabel":"string"},"folder":{"oneOf":[{"description":"Connector folder imported. Null on a file-list import.","type":"string","uniqueKey":"input.oneOf.2.folder.oneOf.0","typeLabel":"string"},{"description":"Connector folder imported. Null on a file-list import.","type":"null","uniqueKey":"input.oneOf.2.folder.oneOf.1","typeLabel":"null"}],"uniqueKey":"input.oneOf.2.folder","typeLabel":"string | null"},"limits":{"description":"The caps the import ran under.","type":"object","properties":{"allow_archives":{"description":"Whether the run was permitted to expand archives.","type":"boolean","uniqueKey":"input.oneOf.2.limits.allow_archives","typeLabel":"boolean"},"allowed_extensions":{"description":"File extensions the run was allowed to ingest.","type":"array","items":{"description":"One permitted file extension.","type":"string","uniqueKey":"input.oneOf.2.limits.allowed_extensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.2.limits.allowed_extensions","typeLabel":"string[]"},"remaining_files":{"description":"Files left under the context's file cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.2.limits.remaining_files","typeLabel":"integer\u003cint64>"},"remaining_bytes":{"description":"Bytes left under the context's byte cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.2.limits.remaining_bytes","typeLabel":"integer\u003cint64>"},"max_file_bytes":{"description":"Upper bound on one stored object.","type":"integer","format":"int64","uniqueKey":"input.oneOf.2.limits.max_file_bytes","typeLabel":"integer\u003cint64>"}},"uniqueKey":"input.oneOf.2.limits","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.2","typeLabel":"Connector import · object"},{"type":"object","title":"Public-repo import","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["provider","url","path"],"properties":{"provider":{"description":"The public-source provider, e.g. `github`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.3.provider","typeLabel":"string"},"url":{"description":"The public repository or archive fetched.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.3.url","typeLabel":"string"},"path":{"description":"Subdirectory under the source tree the import landed in.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.3.path","typeLabel":"string"},"limits":{"description":"The caps the import ran under.","type":"object","properties":{"allow_archives":{"description":"Whether the run was permitted to expand archives.","type":"boolean","uniqueKey":"input.oneOf.3.limits.allow_archives","typeLabel":"boolean"},"allowed_extensions":{"description":"File extensions the run was allowed to ingest.","type":"array","items":{"description":"One permitted file extension.","type":"string","uniqueKey":"input.oneOf.3.limits.allowed_extensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.3.limits.allowed_extensions","typeLabel":"string[]"},"remaining_files":{"description":"Files left under the context's file cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.3.limits.remaining_files","typeLabel":"integer\u003cint64>"},"remaining_bytes":{"description":"Bytes left under the context's byte cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.3.limits.remaining_bytes","typeLabel":"integer\u003cint64>"},"max_file_bytes":{"description":"Upper bound on one stored object.","type":"integer","format":"int64","uniqueKey":"input.oneOf.3.limits.max_file_bytes","typeLabel":"integer\u003cint64>"}},"uniqueKey":"input.oneOf.3.limits","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.3","typeLabel":"Public-repo import · object"},{"type":"object","title":"Archive upload","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["raw_archive_key","path"],"properties":{"raw_archive_key":{"description":"Staging key under the source bucket's `_inbox/` prefix","type":"string","isRequired":true,"uniqueKey":"input.oneOf.4.raw_archive_key","typeLabel":"string"},"path":{"description":"Subdirectory under the source tree the import landed in.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.4.path","typeLabel":"string"},"limits":{"description":"The caps the import ran under.","type":"object","properties":{"allow_archives":{"description":"Whether the run was permitted to expand archives.","type":"boolean","uniqueKey":"input.oneOf.4.limits.allow_archives","typeLabel":"boolean"},"allowed_extensions":{"description":"File extensions the run was allowed to ingest.","type":"array","items":{"description":"One permitted file extension.","type":"string","uniqueKey":"input.oneOf.4.limits.allowed_extensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.4.limits.allowed_extensions","typeLabel":"string[]"},"remaining_files":{"description":"Files left under the context's file cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.4.limits.remaining_files","typeLabel":"integer\u003cint64>"},"remaining_bytes":{"description":"Bytes left under the context's byte cap when the run started.","type":"integer","format":"int64","uniqueKey":"input.oneOf.4.limits.remaining_bytes","typeLabel":"integer\u003cint64>"},"max_file_bytes":{"description":"Upper bound on one stored object.","type":"integer","format":"int64","uniqueKey":"input.oneOf.4.limits.max_file_bytes","typeLabel":"integer\u003cint64>"}},"uniqueKey":"input.oneOf.4.limits","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.4","typeLabel":"Archive upload · object"},{"type":"object","title":"Pack","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["include_traces","slug","context_id"],"properties":{"include_traces":{"description":"Whether query traces were packed alongside sources and knowledge.","type":"boolean","isRequired":true,"uniqueKey":"input.oneOf.5.include_traces","typeLabel":"boolean"},"slug":{"description":"Slug of the packed context; names the output archive.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.5.slug","typeLabel":"string"},"context_id":{"description":"The context that was packed.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.5.context_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"input.oneOf.5","typeLabel":"Pack · object"},{"type":"object","title":"Restore","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["pack_key","pack_filename","target_context_id","target_slug","target_name"],"properties":{"pack_key":{"description":"Object-store key of the pack being restored.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.6.pack_key","typeLabel":"string"},"pack_filename":{"description":"The pack archive's file name.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.6.pack_filename","typeLabel":"string"},"target_context_id":{"description":"The already-created context the pack is restored into.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.6.target_context_id","typeLabel":"string"},"target_slug":{"description":"URL-safe name of the context being written into.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.6.target_slug","typeLabel":"string"},"target_name":{"description":"Human-readable label of the context being written into.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.6.target_name","typeLabel":"string"},"sample_queries":{"description":"Sample queries to seed the target with, taken from the pack. Absent on a pack that carried none.","type":"array","items":{"description":"One sample query carried over from the pack.","type":"string","uniqueKey":"input.oneOf.6.sample_queries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.6.sample_queries","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"input.oneOf.6","typeLabel":"Restore · object"},{"type":"object","title":"Explore","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["guide","trigger"],"properties":{"guide":{"description":"Guidance the proposal was steered with. Empty when none was given.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.7.guide","typeLabel":"string"},"trigger":{"description":"What started the run, e.g. `manual`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.7.trigger","typeLabel":"string"}},"isRequired":true,"uniqueKey":"input.oneOf.7","typeLabel":"Explore · object"},{"type":"object","title":"Profile","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","required":["manifest","trigger"],"properties":{"manifest":{"type":"object","description":"The candidate manifest the run profiles, not a stored one.","properties":{"curate":{"description":"What curate builds out of the sources — the chunk leg, the artifact leg, or both.","type":"object","properties":{"chunks":{"description":"The chunk leg — sources split into passages, embedded for semantic search and optionally indexed for keyword search.","type":"object","properties":{"enabled":{"description":"Whether curate builds the chunk leg at all.","default":true,"type":"boolean","uniqueKey":"input.oneOf.8.manifest.curate.chunks.enabled","typeLabel":"boolean"},"embedding_model":{"description":"Model that embeds the chunks.","default":"multilingual-e5-large","type":"string","maxLength":128,"uniqueKey":"input.oneOf.8.manifest.curate.chunks.embedding_model","typeLabel":"string"},"chunking":{"description":"How a source is cut into chunks.","type":"object","properties":{"strategy":{"description":"Which structure the splitter cuts on — markdown headings, fixed-size windows, HTML elements, CSV rows, or code syntax. Pick the one that matches the corpus.","default":"markdown_heading","x-enum":["markdown_heading","sliding_window","html","csv","code"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.chunks.chunking.strategy","typeLabel":"string"},"target_size":{"description":"Chunk size the splitter aims for, in tokens. Smaller chunks retrieve more precisely; larger ones carry more surrounding context.","default":512,"type":"integer","minimum":64,"maximum":4096,"uniqueKey":"input.oneOf.8.manifest.curate.chunks.chunking.target_size","typeLabel":"integer"},"overlap":{"description":"Tokens each chunk repeats from its predecessor, so a passage split across a boundary is still retrievable whole.","default":64,"type":"integer","minimum":0,"maximum":1024,"uniqueKey":"input.oneOf.8.manifest.curate.chunks.chunking.overlap","typeLabel":"integer"},"respect_sections":{"description":"Never cut across a section boundary, even when that leaves a chunk short of `target_size`.","default":true,"type":"boolean","uniqueKey":"input.oneOf.8.manifest.curate.chunks.chunking.respect_sections","typeLabel":"boolean"}},"uniqueKey":"input.oneOf.8.manifest.curate.chunks.chunking","typeLabel":"object"},"keyword":{"description":"The lexical index built alongside the vectors, for exact-term matching.","type":"object","properties":{"enabled":{"description":"Whether the lexical index is built.","default":true,"type":"boolean","uniqueKey":"input.oneOf.8.manifest.curate.chunks.keyword.enabled","typeLabel":"boolean"}},"uniqueKey":"input.oneOf.8.manifest.curate.chunks.keyword","typeLabel":"object"}},"uniqueKey":"input.oneOf.8.manifest.curate.chunks","typeLabel":"object"},"artifacts":{"description":"The artifact leg: knowledge an LLM distills out of the sources, as prose files or database rows. Off by default.","type":"object","properties":{"enabled":{"description":"Whether curate extracts artifacts at all.","default":false,"type":"boolean","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.enabled","typeLabel":"boolean"},"artifact_model":{"description":"Model tier that does the extraction. `standard` reads more carefully at a higher token cost.","default":"lite","x-enum":["standard","lite"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_model","typeLabel":"string"},"artifact_types":{"description":"What kinds of artifact to extract. Nothing is extracted until at least one is declared.","type":"array","items":{"description":"One kind of artifact to extract. `name` is required of a written manifest; a read echoes a stored document that lacks one rather than failing.","type":"object","properties":{"name":{"description":"What the type is called. Edge endpoints reference it, and a sqlite type's table is named after it.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].name","typeLabel":"string"},"kind":{"description":"What the artifact represents, which selects the extraction prompt. `glossary` is the exception — it reads the headings named in `sections` deterministically, with no LLM call.","default":"topic","x-enum":["summary","topic","entity","event","doc","page","glossary"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].kind","typeLabel":"string"},"scope":{"description":"How widely the extraction reaches. `document` extracts one artifact per source; `corpus` reduces mentions from across every source into one artifact per subject.","default":"corpus","x-enum":["document","corpus"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].scope","typeLabel":"string"},"icon":{"description":"Symbol to display beside artifacts of this kind.","type":"string","maxLength":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].icon","typeLabel":"string"},"description":{"description":"What this type should capture. Goes into the extraction prompt, so it steers the result.","type":"string","maxLength":512,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].description","typeLabel":"string"},"coverage":{"description":"Topics the extraction is told to address wherever the source speaks to them.","type":"array","items":{"description":"One topic the extraction should address.","type":"string","maxLength":128,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].coverage.items.[INDEX]","typeLabel":"string"},"maxItems":32,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].coverage","typeLabel":"string[]"},"sections":{"description":"Exact section headings a `glossary`-kind type reads verbatim. Ignored by every other kind.","type":"array","items":{"description":"One exact section heading to read.","type":"string","maxLength":128,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].sections.items.[INDEX]","typeLabel":"string"},"maxItems":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].sections","typeLabel":"string[]"},"min_doc_count":{"description":"Overrides the manifest-level `min_doc_count` for this type.","default":1,"type":"integer","minimum":1,"maximum":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].min_doc_count","typeLabel":"integer"},"format":{"description":"Where the artifacts of this type are written — `markdown` a prose file each, `sqlite` rows in the context's structured database.","default":"markdown","x-enum":["markdown","sqlite"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].format","typeLabel":"string"},"columns":{"description":"Table schema for a `sqlite`-format type. Ignored for `markdown`. Two names that normalize to the same column collide, and the first declaration wins.","type":"array","items":{"description":"One column of the type's table.","type":"object","properties":{"name":{"description":"Column name.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].name","typeLabel":"string"},"type":{"description":"SQLite column affinity.","default":"TEXT","x-enum":["TEXT","INTEGER","REAL","NUMERIC"],"type":"string","uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].type","typeLabel":"string"},"description":{"description":"What the column holds. Steers the extraction that fills it.","type":"string","maxLength":256,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].description","typeLabel":"string"}},"required":["name"],"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX]","typeLabel":"object"},"maxItems":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].columns","typeLabel":"object[]"},"natural_key":{"description":"Columns that identify a row uniquely, so re-curating a source upserts its rows rather than duplicating them. `sqlite`-format types only.","type":"array","items":{"description":"One column of the upsert key.","type":"string","maxLength":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].natural_key.items.[INDEX]","typeLabel":"string"},"maxItems":16,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX].natural_key","typeLabel":"string[]"}},"required":["name"],"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types.items.[INDEX]","typeLabel":"object"},"maxItems":32,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.artifact_types","typeLabel":"object[]"},"edge_types":{"description":"Typed, directed relationships between artifact types, which turn the artifacts into a graph the agent can traverse.","type":"array","items":{"description":"One typed, directed relationship between artifact types. `name`, `from`, and `to` are required of a written manifest; a read echoes a stored document that lacks one rather than failing.","type":"object","properties":{"name":{"description":"What the relationship is called, e.g. `mentions`.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].name","typeLabel":"string"},"from":{"description":"Source artifact-type name. May equal `to` for a self-referential edge.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].from","typeLabel":"string"},"to":{"description":"Target artifact-type name","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].to","typeLabel":"string"},"description":{"description":"What the relationship means. Steers the extraction that finds it.","type":"string","maxLength":512,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].description","typeLabel":"string"},"attributes":{"description":"Extra properties recorded on each edge, e.g. `count`.","type":"array","items":{"description":"One attribute name.","type":"string","maxLength":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].attributes.items.[INDEX]","typeLabel":"string"},"maxItems":16,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX].attributes","typeLabel":"string[]"}},"required":["name","from","to"],"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types.items.[INDEX]","typeLabel":"object"},"maxItems":32,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.edge_types","typeLabel":"object[]"},"min_doc_count":{"description":"How many source documents must mention a corpus-scoped subject before it earns an artifact. Raise it to suppress one-off mentions. An artifact type may override it.","default":1,"type":"integer","minimum":1,"maximum":64,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.min_doc_count","typeLabel":"integer"},"max_tokens":{"description":"Output cap for one extracted artifact, in tokens.","default":1500,"type":"integer","minimum":128,"maximum":8192,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.max_tokens","typeLabel":"integer"},"max_doc_chars":{"description":"Input cap for one extraction call, in characters. With windowing off this also caps how much of a source is read at all; everything beyond it is dropped.","default":60000,"type":"integer","minimum":1000,"maximum":2000000,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.max_doc_chars","typeLabel":"integer"},"extraction_window_chars":{"description":"Window size for walking a long source across several extraction calls, so its back half is covered rather than dropped. `0` opts out and reads only the head, up to `max_doc_chars`.","default":0,"type":"integer","minimum":0,"maximum":1000000,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.extraction_window_chars","typeLabel":"integer"},"mention_max_chars":{"description":"Cap on one recorded mention — what a single document says about the subject — in characters.","default":400,"type":"integer","minimum":100,"maximum":4000,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.mention_max_chars","typeLabel":"integer"},"max_mentions_per_artifact":{"description":"How many mentions are fed into the pass that reduces them into one corpus-wide artifact.","default":40,"type":"integer","minimum":1,"maximum":500,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.max_mentions_per_artifact","typeLabel":"integer"},"mention_context_chars":{"description":"Cap on those mentions once concatenated, in characters. Applied after `max_mentions_per_artifact`.","default":8000,"type":"integer","minimum":1000,"maximum":100000,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.mention_context_chars","typeLabel":"integer"},"max_artifacts_per_type":{"description":"How many artifacts one type may produce. Omit for no cap.","default":10000,"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"input.oneOf.8.manifest.curate.artifacts.max_artifacts_per_type","typeLabel":"integer"}},"uniqueKey":"input.oneOf.8.manifest.curate.artifacts","typeLabel":"object"}},"uniqueKey":"input.oneOf.8.manifest.curate","typeLabel":"object"},"optimize":{"description":"The scheduled self-tuning loop: it clusters the queries that answered badly and tries candidate manifests against an ephemeral index until one reproduces the recorded answers.","type":"object","properties":{"schedule":{"description":"Cron expression the tuning loop runs on.","default":"0 * * * *","type":"string","maxLength":128,"uniqueKey":"input.oneOf.8.manifest.optimize.schedule","typeLabel":"string"},"latency_threshold_ms":{"description":"A query slower than this counts as a problem worth tuning for, as does any query that fell back from artifacts to chunks. `0` disables the latency test, leaving only fallback.","default":60000,"type":"integer","minimum":0,"maximum":600000,"uniqueKey":"input.oneOf.8.manifest.optimize.latency_threshold_ms","typeLabel":"integer"},"min_group_size":{"description":"How many near-duplicate problem queries must cluster together before the loop tunes for them. Keeps a one-off slow query from triggering a manifest change.","default":2,"type":"integer","minimum":1,"maximum":100,"uniqueKey":"input.oneOf.8.manifest.optimize.min_group_size","typeLabel":"integer"},"eval_pass_rate_threshold":{"description":"Fraction of eval queries a candidate manifest must answer correctly to be considered ready. `1` demands all of them.","default":1,"type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"input.oneOf.8.manifest.optimize.eval_pass_rate_threshold","typeLabel":"number\u003cdouble>"},"max_iterations":{"description":"How many candidate manifests the loop tries before stopping with its best.","default":20,"type":"integer","minimum":1,"maximum":100,"uniqueKey":"input.oneOf.8.manifest.optimize.max_iterations","typeLabel":"integer"}},"uniqueKey":"input.oneOf.8.manifest.optimize","typeLabel":"object"},"search":{"description":"Standing instructions for the query runtime, pinned on the context rather than sent per turn.","type":"object","properties":{"instructions":{"description":"The context's default system prompt, applied to every turn in scope. A session's own `system_prompt` appends to it rather than replacing it.","type":"string","uniqueKey":"input.oneOf.8.manifest.search.instructions","typeLabel":"string"}},"uniqueKey":"input.oneOf.8.manifest.search","typeLabel":"object"}},"isRequired":true,"uniqueKey":"input.oneOf.8.manifest","typeLabel":"object"},"trigger":{"description":"What started the run, e.g. `manual`.","type":"string","isRequired":true,"uniqueKey":"input.oneOf.8.trigger","typeLabel":"string"}},"isRequired":true,"uniqueKey":"input.oneOf.8","typeLabel":"Profile · object"},{"type":"object","title":"Optimize","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","properties":{"candidate_queries":{"description":"The queries the run tunes toward. Absent makes the run a no-op.","type":"array","items":{"description":"A query the optimize run tunes toward.","type":"object","properties":{"ask":{"description":"The question to tune retrieval against.","type":"string","uniqueKey":"input.oneOf.9.candidate_queries.items.[INDEX].ask","typeLabel":"string"},"answer":{"description":"Used as eval ground truth","type":"string","uniqueKey":"input.oneOf.9.candidate_queries.items.[INDEX].answer","typeLabel":"string"},"fallback_to_chunks":{"description":"Whether answering this query had to drill from artifacts down to chunks.","type":"boolean","uniqueKey":"input.oneOf.9.candidate_queries.items.[INDEX].fallback_to_chunks","typeLabel":"boolean"},"latency_ms":{"description":"Latency the query showed in real traffic, as a tuning baseline.","type":"number","format":"double","uniqueKey":"input.oneOf.9.candidate_queries.items.[INDEX].latency_ms","typeLabel":"number\u003cdouble>"}},"uniqueKey":"input.oneOf.9.candidate_queries.items.[INDEX]","typeLabel":"object"},"uniqueKey":"input.oneOf.9.candidate_queries","typeLabel":"object[]"},"eval_pass_rate_threshold":{"description":"Pass rate an iteration must clear to count as ready.","type":"number","format":"double","uniqueKey":"input.oneOf.9.eval_pass_rate_threshold","typeLabel":"number\u003cdouble>"},"retrieval_p90_latency_ms":{"description":"The p90 latency bar an iteration must stay under.","type":"integer","format":"int64","uniqueKey":"input.oneOf.9.retrieval_p90_latency_ms","typeLabel":"integer\u003cint64>"},"optimize_timeout_seconds":{"description":"Runtime budget for the whole optimize.","type":"integer","format":"int64","uniqueKey":"input.oneOf.9.optimize_timeout_seconds","typeLabel":"integer\u003cint64>"},"max_tool_turns":{"description":"Cap on tool-loop turns per eval query.","type":"integer","uniqueKey":"input.oneOf.9.max_tool_turns","typeLabel":"integer"},"max_iterations":{"description":"Cap on candidate manifests tried.","type":"integer","uniqueKey":"input.oneOf.9.max_iterations","typeLabel":"integer"},"models":{"description":"Tier names or catalog ids, in preference order.","type":"array","items":{"description":"A tier name or catalog id.","type":"string","uniqueKey":"input.oneOf.9.models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.9.models","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"input.oneOf.9","typeLabel":"Optimize · object"},{"type":"object","title":"Groom","description":"A task's per-workflow `input`. It carries no discriminant of its own — the sibling `workflow` field selects the shape.","properties":{"budget":{"description":"Cap on fact batches the run consolidates.","type":"integer","uniqueKey":"input.oneOf.10.budget","typeLabel":"integer"},"groom_timeout_seconds":{"description":"Runtime budget for the whole groom.","type":"integer","format":"int64","uniqueKey":"input.oneOf.10.groom_timeout_seconds","typeLabel":"integer\u003cint64>"},"models":{"description":"Tier names or catalog ids, in preference order.","type":"array","items":{"description":"A tier name or catalog id.","type":"string","uniqueKey":"input.oneOf.10.models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"input.oneOf.10.models","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"input.oneOf.10","typeLabel":"Groom · object"}],"isRequired":true,"uniqueKey":"input","typeLabel":"Search / search_cc / search_rag / work · object | Curate · object | Connector import · object | Public-repo import · object | Archive upload · object | Pack · object | Restore · object | Explore · object | Profile · object | Optimize · object | Groom · object"},"steps":{"description":"Populated only on GET /tasks/{id}. May be a trailing window when `steps_limit` was given, so read the count from `steps_total` rather than this array's length.","type":"array","items":{"description":"One reported step row. `step_id` and `status` are always set; the rest are per-workflow optionals, so an absent key stays absent.","type":"object","properties":{"step_id":{"description":"Identifies the step within the task.","type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].step_id","typeLabel":"string"},"status":{"description":"How the step ended, e.g. `running` or `completed`.","type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].status","typeLabel":"string"},"type":{"description":"What kind of step this is; the vocabulary is per-workflow.","type":"string","uniqueKey":"steps.items.[INDEX].type","typeLabel":"string"},"content":{"description":"The step's reported text payload.","type":"string","uniqueKey":"steps.items.[INDEX].content","typeLabel":"string"},"commentary":{"description":"The runtime's one-line account of what the step is doing.","type":"string","uniqueKey":"steps.items.[INDEX].commentary","typeLabel":"string"},"code":{"description":"Redacted tool input (search)","type":"string","uniqueKey":"steps.items.[INDEX].code","typeLabel":"string"},"result":{"description":"Redacted tool output (search)","type":"string","uniqueKey":"steps.items.[INDEX].result","typeLabel":"string"},"cum_input_tokens":{"description":"Task-to-date input tokens, including this step.","type":"integer","format":"int64","uniqueKey":"steps.items.[INDEX].cum_input_tokens","typeLabel":"integer\u003cint64>"},"cum_output_tokens":{"description":"Task-to-date output tokens, including this step.","type":"integer","format":"int64","uniqueKey":"steps.items.[INDEX].cum_output_tokens","typeLabel":"integer\u003cint64>"},"job_id":{"description":"Identifier of the LlamaParse job doing the work.","type":"string","uniqueKey":"steps.items.[INDEX].job_id","typeLabel":"string"},"path":{"description":"Source path being parsed","type":"string","uniqueKey":"steps.items.[INDEX].path","typeLabel":"string"}},"required":["step_id","status"],"uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"tokens_prompt":{"description":"Input tokens the run has billed so far.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"tokens_prompt","typeLabel":"integer\u003cint64>"},"tokens_completion":{"description":"Output tokens the run has billed so far.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"tokens_completion","typeLabel":"integer\u003cint64>"},"runtime_seconds":{"description":"Seconds the container has been running.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"runtime_seconds","typeLabel":"integer\u003cint64>"},"created_at":{"description":"When the task row was created.","type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"context_id":{"oneOf":[{"description":"The context the run acts on. Null for a task that belongs to no context.","type":"string","uniqueKey":"context_id.oneOf.0","typeLabel":"string"},{"description":"The context the run acts on. Null for a task that belongs to no context.","type":"null","uniqueKey":"context_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"context_id","typeLabel":"string | null"},"agent_id":{"oneOf":[{"description":"Reserved. Null on every task this version serves.","type":"string","uniqueKey":"agent_id.oneOf.0","typeLabel":"string"},{"description":"Reserved. Null on every task this version serves.","type":"null","uniqueKey":"agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agent_id","typeLabel":"string | null"},"session_id":{"oneOf":[{"description":"Set for query turns","type":"string","uniqueKey":"session_id.oneOf.0","typeLabel":"string"},{"description":"Set for query turns","type":"null","uniqueKey":"session_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"session_id","typeLabel":"string | null"},"error":{"oneOf":[{"description":"Failure detail. Set on a `failed` task.","type":"string","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"description":"Failure detail. Set on a `failed` task.","type":"null","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"output":{"oneOf":[{"type":"object","title":"Search / search_rag completed","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","query_id","answer","citations","latency_ms"],"properties":{"status":{"description":"How the turn ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.0.status","typeLabel":"string"},"query_id":{"description":"The turn this task answered.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.0.query_id","typeLabel":"string"},"answer":{"description":"The answer text.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.0.answer","typeLabel":"string"},"citations":{"description":"Cited source paths. The turn carries the structured form.","type":"array","items":{"description":"A cited source path.","type":"string","uniqueKey":"output.oneOf.0.citations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.0.citations","typeLabel":"string[]"},"latency_ms":{"description":"Wall time for the turn.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.0.latency_ms","typeLabel":"integer\u003cint64>"},"output_json":{"oneOf":[{"description":"Structured answer when the turn carried a shape, or the hits on a retrieval-only turn. Absent otherwise.","type":"object","additionalProperties":true,"uniqueKey":"output.oneOf.0.output_json.oneOf.0","typeLabel":"object"},{"description":"Structured answer when the turn carried a shape, or the hits on a retrieval-only turn. Absent otherwise.","type":"null","additionalProperties":true,"uniqueKey":"output.oneOf.0.output_json.oneOf.1","typeLabel":"null"}],"uniqueKey":"output.oneOf.0.output_json","typeLabel":"object | null"},"unknown_models":{"description":"Model selections dropped as unknown before dispatch, so a caller whose pin was silently ignored can see it. Absent when nothing was dropped.","type":"array","items":{"description":"A requested model id or tier name the project's catalog does not carry.","type":"string","uniqueKey":"output.oneOf.0.unknown_models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"output.oneOf.0.unknown_models","typeLabel":"string[]"}},"uniqueKey":"output.oneOf.0","typeLabel":"Search / search_rag completed · object"},{"type":"object","title":"Search-as-code completed","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","query_id","answer","citations","latency_ms","steps"],"properties":{"status":{"description":"How the turn ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.1.status","typeLabel":"string"},"query_id":{"description":"The turn this task answered.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.1.query_id","typeLabel":"string"},"answer":{"description":"The answer text.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.1.answer","typeLabel":"string"},"citations":{"description":"Cited source paths.","type":"array","items":{"description":"A cited source path.","type":"string","uniqueKey":"output.oneOf.1.citations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.1.citations","typeLabel":"string[]"},"latency_ms":{"description":"Wall time for the turn.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.1.latency_ms","typeLabel":"integer\u003cint64>"},"steps":{"description":"Reasoning steps the turn ran.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.1.steps","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.1","typeLabel":"Search-as-code completed · object"},{"type":"object","title":"Search failed","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","query_id","error"],"properties":{"status":{"description":"How the turn ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.2.status","typeLabel":"string"},"query_id":{"description":"The turn that failed.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.2.query_id","typeLabel":"string"},"error":{"description":"Why the turn failed.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.2.error","typeLabel":"string"}},"uniqueKey":"output.oneOf.2","typeLabel":"Search failed · object"},{"type":"object","title":"Pack running","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","slug"],"properties":{"state":{"description":"Always `running`. Which report this is shows in the keys it carries, not here.","x-enum":["running"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.3.state","typeLabel":"string"},"slug":{"description":"Slug of the context being packed.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.3.slug","typeLabel":"string"},"include_traces":{"description":"Whether query traces are being packed. Absent on the write-progress report.","type":"boolean","uniqueKey":"output.oneOf.3.include_traces","typeLabel":"boolean"},"started_at":{"description":"When the pack started. Absent on the write-progress report.","type":"string","uniqueKey":"output.oneOf.3.started_at","typeLabel":"string"},"sources_total":{"description":"Source files to be packed. Absent until the inventory is counted.","type":"integer","format":"int64","uniqueKey":"output.oneOf.3.sources_total","typeLabel":"integer\u003cint64>"},"knowledge_total":{"description":"Curated knowledge files to be packed. Absent until the inventory is counted.","type":"integer","format":"int64","uniqueKey":"output.oneOf.3.knowledge_total","typeLabel":"integer\u003cint64>"},"traces_total":{"description":"Trace blobs to be packed. Absent until the inventory is counted.","type":"integer","format":"int64","uniqueKey":"output.oneOf.3.traces_total","typeLabel":"integer\u003cint64>"},"bytes_collected":{"description":"Bytes read so far. Absent until the inventory is counted.","type":"integer","format":"int64","uniqueKey":"output.oneOf.3.bytes_collected","typeLabel":"integer\u003cint64>"},"enriching":{"description":"Present while the LLM writes the pack's summary.","type":"boolean","uniqueKey":"output.oneOf.3.enriching","typeLabel":"boolean"},"files_written":{"description":"Files written into the archive so far. Present only once writing has begun.","type":"integer","format":"int64","uniqueKey":"output.oneOf.3.files_written","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.3","typeLabel":"Pack running · object"},{"type":"object","title":"Pack completed","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","pack_filename","pack_size","sources_files","knowledge_files","traces_included","traces_files","corpus_groups_included","started_at","completed_at","details"],"properties":{"state":{"description":"Which stage of the pack this report describes.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.4.state","typeLabel":"string"},"pack_filename":{"description":"Name of the written archive, `\u003cslug>.context.zip`.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.4.pack_filename","typeLabel":"string"},"pack_size":{"description":"Byte size of the archive.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.4.pack_size","typeLabel":"integer\u003cint64>"},"sources_files":{"description":"How many corpus documents went into the archive.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.4.sources_files","typeLabel":"integer\u003cint64>"},"knowledge_files":{"description":"How many curated documents went into the archive.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.4.knowledge_files","typeLabel":"integer\u003cint64>"},"traces_included":{"description":"Whether query traces were included.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.4.traces_included","typeLabel":"boolean"},"traces_files":{"description":"Trace blobs packed.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.4.traces_files","typeLabel":"integer\u003cint64>"},"corpus_groups_included":{"description":"Corpus groups carried over from the curation ledger.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.4.corpus_groups_included","typeLabel":"integer\u003cint64>"},"started_at":{"description":"When the pack started.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.4.started_at","typeLabel":"string"},"completed_at":{"description":"When the pack finished.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.4.completed_at","typeLabel":"string"},"details":{"oneOf":[{"description":"LLM-written corpus summary, echoed from the pack's `details.json`. Null when enrichment was skipped or failed.","type":"object","properties":{"description":{"description":"Prose summary of what the packed corpus covers.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.4.details.oneOf.0.description","typeLabel":"string"},"sample_queries":{"description":"Example questions the packed corpus can answer.","type":"array","items":{"description":"One example question.","type":"string","uniqueKey":"output.oneOf.4.details.oneOf.0.sample_queries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.4.details.oneOf.0.sample_queries","typeLabel":"string[]"}},"required":["description","sample_queries"],"isRequired":true,"uniqueKey":"output.oneOf.4.details.oneOf.0","typeLabel":"object"},{"description":"LLM-written corpus summary, echoed from the pack's `details.json`. Null when enrichment was skipped or failed.","type":"null","properties":{"description":{"description":"Prose summary of what the packed corpus covers.","type":"string"},"sample_queries":{"description":"Example questions the packed corpus can answer.","type":"array","items":{"description":"One example question.","type":"string"}}},"required":["description","sample_queries"],"isRequired":true,"uniqueKey":"output.oneOf.4.details.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"output.oneOf.4.details","typeLabel":"object | null"}},"uniqueKey":"output.oneOf.4","typeLabel":"Pack completed · object"},{"type":"object","title":"Restore running","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state"],"properties":{"state":{"description":"Always `running`. Which report this is shows in the keys it carries, not here.","x-enum":["running"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.5.state","typeLabel":"string"},"pack_filename":{"description":"The pack archive's file name. Absent on the staging report.","type":"string","uniqueKey":"output.oneOf.5.pack_filename","typeLabel":"string"},"pack_size":{"description":"Byte size of the pack archive. Present once it has been fetched.","type":"integer","format":"int64","uniqueKey":"output.oneOf.5.pack_size","typeLabel":"integer\u003cint64>"},"target_context_id":{"description":"The context the pack is restored into. Absent on the staging report.","type":"string","uniqueKey":"output.oneOf.5.target_context_id","typeLabel":"string"},"target_slug":{"description":"Slug of that target context. Absent from the unzip and staging reports.","type":"string","uniqueKey":"output.oneOf.5.target_slug","typeLabel":"string"},"started_at":{"description":"When the restore started. Present on the first report only.","type":"string","uniqueKey":"output.oneOf.5.started_at","typeLabel":"string"},"stage_progress":{"type":"object","description":"How far the current phase has got. Absent on the first report, before any phase begins.","required":["phase","done","total"],"properties":{"phase":{"description":"Which phase is running, e.g. `stage_sources`.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.5.stage_progress.phase","typeLabel":"string"},"done":{"description":"Items finished in this phase.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.5.stage_progress.done","typeLabel":"integer\u003cint64>"},"total":{"description":"Items this phase will process.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.5.stage_progress.total","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.5.stage_progress","typeLabel":"object"},"sources_count":{"description":"Source files found in the pack. Present once it has been expanded.","type":"integer","format":"int64","uniqueKey":"output.oneOf.5.sources_count","typeLabel":"integer\u003cint64>"},"knowledge_count":{"description":"Knowledge files found in the pack. Present once it has been expanded.","type":"integer","format":"int64","uniqueKey":"output.oneOf.5.knowledge_count","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.5","typeLabel":"Restore running · object"},{"type":"object","title":"Restore completed","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","pack_filename","pack_size","target_context_id","target_slug","sources_staged","knowledge_staged","manifest_set","corpus_groups_set","sample_queries","started_at","completed_at"],"properties":{"state":{"description":"Which stage of the restore this report describes.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.state","typeLabel":"string"},"pack_filename":{"description":"The pack archive's file name.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.pack_filename","typeLabel":"string"},"pack_size":{"description":"How large the archive is on disk.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.6.pack_size","typeLabel":"integer\u003cint64>"},"target_context_id":{"description":"The context the pack is restored into.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.target_context_id","typeLabel":"string"},"target_slug":{"description":"URL-safe name of the context being written into.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.target_slug","typeLabel":"string"},"sources_staged":{"description":"Source files written into the target.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.6.sources_staged","typeLabel":"integer\u003cint64>"},"knowledge_staged":{"description":"Knowledge files written into the target.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.6.knowledge_staged","typeLabel":"integer\u003cint64>"},"manifest_set":{"description":"Whether the pack's manifest was pinned onto the target.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.6.manifest_set","typeLabel":"boolean"},"corpus_groups_set":{"description":"Corpus groups written into the target's curation ledger.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.6.corpus_groups_set","typeLabel":"integer\u003cint64>"},"sample_queries":{"description":"Sample queries carried from the pack onto the target. Empty when the pack had none.","type":"array","items":{"description":"One sample query set on the target.","type":"string","uniqueKey":"output.oneOf.6.sample_queries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.6.sample_queries","typeLabel":"string[]"},"started_at":{"description":"When the restore started.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.started_at","typeLabel":"string"},"completed_at":{"description":"When the restore finished.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.6.completed_at","typeLabel":"string"}},"uniqueKey":"output.oneOf.6","typeLabel":"Restore completed · object"},{"type":"object","title":"Optimize result","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","best_score","best_iteration","best_latency_ok","total_iterations","pass_rate_threshold","p90_latency_limit_ms","elapsed_seconds","usage","models","manifest","changed_legs"],"properties":{"status":{"description":"Set to `ready` only when the best iteration cleared both the pass-rate and latency bars.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.7.status","typeLabel":"string"},"best_score":{"description":"Eval pass rate the best iteration scored, 0–1.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.7.best_score","typeLabel":"number\u003cdouble>"},"best_iteration":{"description":"Which iteration scored it.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.best_iteration","typeLabel":"integer\u003cint64>"},"best_latency_ok":{"description":"Whether that iteration also stayed under the latency bar.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.7.best_latency_ok","typeLabel":"boolean"},"total_iterations":{"description":"Candidate manifests tried.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.total_iterations","typeLabel":"integer\u003cint64>"},"pass_rate_threshold":{"description":"The pass-rate bar the run measured against.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.7.pass_rate_threshold","typeLabel":"number\u003cdouble>"},"p90_latency_limit_ms":{"oneOf":[{"description":"The p90 latency bar. Null when latency was not gated.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.7.p90_latency_limit_ms.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"The p90 latency bar. Null when latency was not gated.","type":"null","format":"double","isRequired":true,"uniqueKey":"output.oneOf.7.p90_latency_limit_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"output.oneOf.7.p90_latency_limit_ms","typeLabel":"number\u003cdouble> | null"},"elapsed_seconds":{"description":"Wall time for the whole loop.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.7.elapsed_seconds","typeLabel":"number\u003cdouble>"},"usage":{"description":"What a run billed on the chat seam, in tokens. Reported by the inference client, which carries the cache-token fields. Used by optimize and explore.","type":"object","properties":{"prompt_tokens":{"description":"Input tokens billed across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.completion_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.total_tokens","typeLabel":"integer\u003cint64>"},"by_model":{"description":"Keyed by the model the proxy actually dispatched to, so tier fallbacks are visible.","type":"object","additionalProperties":{"description":"Per-model chat-seam counts; both usage roll-ups write every key.","type":"object","properties":{"tier":{"description":"Which tier resolved to this model, so a tier fallback is visible.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.tier","typeLabel":"string"},"prompt_tokens":{"description":"Input tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.completion_tokens","typeLabel":"integer\u003cint64>"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.cache_write_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens for this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties.total_tokens","typeLabel":"integer\u003cint64>"}},"required":["tier","prompt_tokens","completion_tokens","cache_read_tokens","cache_write_tokens","total_tokens"],"uniqueKey":"output.oneOf.7.usage.by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.7.usage.by_model","typeLabel":"object"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.7.usage.cache_write_tokens","typeLabel":"integer\u003cint64>"}},"required":["prompt_tokens","completion_tokens","total_tokens","by_model","cache_read_tokens","cache_write_tokens"],"isRequired":true,"uniqueKey":"output.oneOf.7.usage","typeLabel":"object"},"models":{"description":"Tier → resolved model id.","type":"object","additionalProperties":{"description":"The model id the tier resolved to.","type":"string","uniqueKey":"output.oneOf.7.models.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.7.models","typeLabel":"object"},"manifest":{"type":"object","description":"The tuned manifest persisted onto the context when the task completes.","properties":{"curate":{"description":"What curate builds out of the sources — the chunk leg, the artifact leg, or both.","type":"object","properties":{"chunks":{"description":"The chunk leg — sources split into passages, embedded for semantic search and optionally indexed for keyword search.","type":"object","properties":{"enabled":{"description":"Whether curate builds the chunk leg at all.","default":true,"type":"boolean","uniqueKey":"output.oneOf.7.manifest.curate.chunks.enabled","typeLabel":"boolean"},"embedding_model":{"description":"Model that embeds the chunks.","default":"multilingual-e5-large","type":"string","maxLength":128,"uniqueKey":"output.oneOf.7.manifest.curate.chunks.embedding_model","typeLabel":"string"},"chunking":{"description":"How a source is cut into chunks.","type":"object","properties":{"strategy":{"description":"Which structure the splitter cuts on — markdown headings, fixed-size windows, HTML elements, CSV rows, or code syntax. Pick the one that matches the corpus.","default":"markdown_heading","x-enum":["markdown_heading","sliding_window","html","csv","code"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.chunks.chunking.strategy","typeLabel":"string"},"target_size":{"description":"Chunk size the splitter aims for, in tokens. Smaller chunks retrieve more precisely; larger ones carry more surrounding context.","default":512,"type":"integer","minimum":64,"maximum":4096,"uniqueKey":"output.oneOf.7.manifest.curate.chunks.chunking.target_size","typeLabel":"integer"},"overlap":{"description":"Tokens each chunk repeats from its predecessor, so a passage split across a boundary is still retrievable whole.","default":64,"type":"integer","minimum":0,"maximum":1024,"uniqueKey":"output.oneOf.7.manifest.curate.chunks.chunking.overlap","typeLabel":"integer"},"respect_sections":{"description":"Never cut across a section boundary, even when that leaves a chunk short of `target_size`.","default":true,"type":"boolean","uniqueKey":"output.oneOf.7.manifest.curate.chunks.chunking.respect_sections","typeLabel":"boolean"}},"uniqueKey":"output.oneOf.7.manifest.curate.chunks.chunking","typeLabel":"object"},"keyword":{"description":"The lexical index built alongside the vectors, for exact-term matching.","type":"object","properties":{"enabled":{"description":"Whether the lexical index is built.","default":true,"type":"boolean","uniqueKey":"output.oneOf.7.manifest.curate.chunks.keyword.enabled","typeLabel":"boolean"}},"uniqueKey":"output.oneOf.7.manifest.curate.chunks.keyword","typeLabel":"object"}},"uniqueKey":"output.oneOf.7.manifest.curate.chunks","typeLabel":"object"},"artifacts":{"description":"The artifact leg: knowledge an LLM distills out of the sources, as prose files or database rows. Off by default.","type":"object","properties":{"enabled":{"description":"Whether curate extracts artifacts at all.","default":false,"type":"boolean","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.enabled","typeLabel":"boolean"},"artifact_model":{"description":"Model tier that does the extraction. `standard` reads more carefully at a higher token cost.","default":"lite","x-enum":["standard","lite"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_model","typeLabel":"string"},"artifact_types":{"description":"What kinds of artifact to extract. Nothing is extracted until at least one is declared.","type":"array","items":{"description":"One kind of artifact to extract. `name` is required of a written manifest; a read echoes a stored document that lacks one rather than failing.","type":"object","properties":{"name":{"description":"What the type is called. Edge endpoints reference it, and a sqlite type's table is named after it.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].name","typeLabel":"string"},"kind":{"description":"What the artifact represents, which selects the extraction prompt. `glossary` is the exception — it reads the headings named in `sections` deterministically, with no LLM call.","default":"topic","x-enum":["summary","topic","entity","event","doc","page","glossary"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].kind","typeLabel":"string"},"scope":{"description":"How widely the extraction reaches. `document` extracts one artifact per source; `corpus` reduces mentions from across every source into one artifact per subject.","default":"corpus","x-enum":["document","corpus"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].scope","typeLabel":"string"},"icon":{"description":"Symbol to display beside artifacts of this kind.","type":"string","maxLength":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].icon","typeLabel":"string"},"description":{"description":"What this type should capture. Goes into the extraction prompt, so it steers the result.","type":"string","maxLength":512,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].description","typeLabel":"string"},"coverage":{"description":"Topics the extraction is told to address wherever the source speaks to them.","type":"array","items":{"description":"One topic the extraction should address.","type":"string","maxLength":128,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].coverage.items.[INDEX]","typeLabel":"string"},"maxItems":32,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].coverage","typeLabel":"string[]"},"sections":{"description":"Exact section headings a `glossary`-kind type reads verbatim. Ignored by every other kind.","type":"array","items":{"description":"One exact section heading to read.","type":"string","maxLength":128,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].sections.items.[INDEX]","typeLabel":"string"},"maxItems":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].sections","typeLabel":"string[]"},"min_doc_count":{"description":"Overrides the manifest-level `min_doc_count` for this type.","default":1,"type":"integer","minimum":1,"maximum":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].min_doc_count","typeLabel":"integer"},"format":{"description":"Where the artifacts of this type are written — `markdown` a prose file each, `sqlite` rows in the context's structured database.","default":"markdown","x-enum":["markdown","sqlite"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].format","typeLabel":"string"},"columns":{"description":"Table schema for a `sqlite`-format type. Ignored for `markdown`. Two names that normalize to the same column collide, and the first declaration wins.","type":"array","items":{"description":"One column of the type's table.","type":"object","properties":{"name":{"description":"Column name.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].name","typeLabel":"string"},"type":{"description":"SQLite column affinity.","default":"TEXT","x-enum":["TEXT","INTEGER","REAL","NUMERIC"],"type":"string","uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].type","typeLabel":"string"},"description":{"description":"What the column holds. Steers the extraction that fills it.","type":"string","maxLength":256,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX].description","typeLabel":"string"}},"required":["name"],"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].columns.items.[INDEX]","typeLabel":"object"},"maxItems":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].columns","typeLabel":"object[]"},"natural_key":{"description":"Columns that identify a row uniquely, so re-curating a source upserts its rows rather than duplicating them. `sqlite`-format types only.","type":"array","items":{"description":"One column of the upsert key.","type":"string","maxLength":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].natural_key.items.[INDEX]","typeLabel":"string"},"maxItems":16,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX].natural_key","typeLabel":"string[]"}},"required":["name"],"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types.items.[INDEX]","typeLabel":"object"},"maxItems":32,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.artifact_types","typeLabel":"object[]"},"edge_types":{"description":"Typed, directed relationships between artifact types, which turn the artifacts into a graph the agent can traverse.","type":"array","items":{"description":"One typed, directed relationship between artifact types. `name`, `from`, and `to` are required of a written manifest; a read echoes a stored document that lacks one rather than failing.","type":"object","properties":{"name":{"description":"What the relationship is called, e.g. `mentions`.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].name","typeLabel":"string"},"from":{"description":"Source artifact-type name. May equal `to` for a self-referential edge.","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].from","typeLabel":"string"},"to":{"description":"Target artifact-type name","type":"string","maxLength":64,"isRequired":true,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].to","typeLabel":"string"},"description":{"description":"What the relationship means. Steers the extraction that finds it.","type":"string","maxLength":512,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].description","typeLabel":"string"},"attributes":{"description":"Extra properties recorded on each edge, e.g. `count`.","type":"array","items":{"description":"One attribute name.","type":"string","maxLength":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].attributes.items.[INDEX]","typeLabel":"string"},"maxItems":16,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX].attributes","typeLabel":"string[]"}},"required":["name","from","to"],"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types.items.[INDEX]","typeLabel":"object"},"maxItems":32,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.edge_types","typeLabel":"object[]"},"min_doc_count":{"description":"How many source documents must mention a corpus-scoped subject before it earns an artifact. Raise it to suppress one-off mentions. An artifact type may override it.","default":1,"type":"integer","minimum":1,"maximum":64,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.min_doc_count","typeLabel":"integer"},"max_tokens":{"description":"Output cap for one extracted artifact, in tokens.","default":1500,"type":"integer","minimum":128,"maximum":8192,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.max_tokens","typeLabel":"integer"},"max_doc_chars":{"description":"Input cap for one extraction call, in characters. With windowing off this also caps how much of a source is read at all; everything beyond it is dropped.","default":60000,"type":"integer","minimum":1000,"maximum":2000000,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.max_doc_chars","typeLabel":"integer"},"extraction_window_chars":{"description":"Window size for walking a long source across several extraction calls, so its back half is covered rather than dropped. `0` opts out and reads only the head, up to `max_doc_chars`.","default":0,"type":"integer","minimum":0,"maximum":1000000,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.extraction_window_chars","typeLabel":"integer"},"mention_max_chars":{"description":"Cap on one recorded mention — what a single document says about the subject — in characters.","default":400,"type":"integer","minimum":100,"maximum":4000,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.mention_max_chars","typeLabel":"integer"},"max_mentions_per_artifact":{"description":"How many mentions are fed into the pass that reduces them into one corpus-wide artifact.","default":40,"type":"integer","minimum":1,"maximum":500,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.max_mentions_per_artifact","typeLabel":"integer"},"mention_context_chars":{"description":"Cap on those mentions once concatenated, in characters. Applied after `max_mentions_per_artifact`.","default":8000,"type":"integer","minimum":1000,"maximum":100000,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.mention_context_chars","typeLabel":"integer"},"max_artifacts_per_type":{"description":"How many artifacts one type may produce. Omit for no cap.","default":10000,"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"output.oneOf.7.manifest.curate.artifacts.max_artifacts_per_type","typeLabel":"integer"}},"uniqueKey":"output.oneOf.7.manifest.curate.artifacts","typeLabel":"object"}},"uniqueKey":"output.oneOf.7.manifest.curate","typeLabel":"object"},"optimize":{"description":"The scheduled self-tuning loop: it clusters the queries that answered badly and tries candidate manifests against an ephemeral index until one reproduces the recorded answers.","type":"object","properties":{"schedule":{"description":"Cron expression the tuning loop runs on.","default":"0 * * * *","type":"string","maxLength":128,"uniqueKey":"output.oneOf.7.manifest.optimize.schedule","typeLabel":"string"},"latency_threshold_ms":{"description":"A query slower than this counts as a problem worth tuning for, as does any query that fell back from artifacts to chunks. `0` disables the latency test, leaving only fallback.","default":60000,"type":"integer","minimum":0,"maximum":600000,"uniqueKey":"output.oneOf.7.manifest.optimize.latency_threshold_ms","typeLabel":"integer"},"min_group_size":{"description":"How many near-duplicate problem queries must cluster together before the loop tunes for them. Keeps a one-off slow query from triggering a manifest change.","default":2,"type":"integer","minimum":1,"maximum":100,"uniqueKey":"output.oneOf.7.manifest.optimize.min_group_size","typeLabel":"integer"},"eval_pass_rate_threshold":{"description":"Fraction of eval queries a candidate manifest must answer correctly to be considered ready. `1` demands all of them.","default":1,"type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"output.oneOf.7.manifest.optimize.eval_pass_rate_threshold","typeLabel":"number\u003cdouble>"},"max_iterations":{"description":"How many candidate manifests the loop tries before stopping with its best.","default":20,"type":"integer","minimum":1,"maximum":100,"uniqueKey":"output.oneOf.7.manifest.optimize.max_iterations","typeLabel":"integer"}},"uniqueKey":"output.oneOf.7.manifest.optimize","typeLabel":"object"},"search":{"description":"Standing instructions for the query runtime, pinned on the context rather than sent per turn.","type":"object","properties":{"instructions":{"description":"The context's default system prompt, applied to every turn in scope. A session's own `system_prompt` appends to it rather than replacing it.","type":"string","uniqueKey":"output.oneOf.7.manifest.search.instructions","typeLabel":"string"}},"uniqueKey":"output.oneOf.7.manifest.search","typeLabel":"object"}},"isRequired":true,"uniqueKey":"output.oneOf.7.manifest","typeLabel":"object"},"changed_legs":{"description":"Which manifest legs the tuning changed, so a re-curate can be scoped to them.","type":"array","items":{"description":"A manifest leg the tuning changed.","type":"string","uniqueKey":"output.oneOf.7.changed_legs.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.7.changed_legs","typeLabel":"string[]"},"unknown_models":{"description":"Model selections dropped as unknown before dispatch, so a caller whose pin was silently ignored can see it. Absent when nothing was dropped.","type":"array","items":{"description":"A requested model id or tier name the project's catalog does not carry.","type":"string","uniqueKey":"output.oneOf.7.unknown_models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"output.oneOf.7.unknown_models","typeLabel":"string[]"}},"uniqueKey":"output.oneOf.7","typeLabel":"Optimize result · object"},{"type":"object","title":"Optimize no-op","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","reason","candidate_queries","problems"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.8.status","typeLabel":"string"},"reason":{"description":"Which gate the run stopped at.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.8.reason","typeLabel":"string"},"candidate_queries":{"description":"Candidate queries the run was given.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.8.candidate_queries","typeLabel":"integer\u003cint64>"},"problems":{"description":"How many of those counted as problems worth tuning for.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.8.problems","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.8","typeLabel":"Optimize no-op · object"},{"type":"object","title":"Groom","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","budget","batches_staged","batches_consumed","facts_distilled","facts_added","facts_merged","facts_dropped_untyped","edges_added","artifacts_pruned","artifact_files_written","artifact_files_deleted","artifact_count","artifact_bytes","duration_ms"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.9.status","typeLabel":"string"},"budget":{"description":"Fact batches the run was allowed to consume.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.budget","typeLabel":"integer\u003cint64>"},"batches_staged":{"description":"Batches available to consume.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.batches_staged","typeLabel":"integer\u003cint64>"},"batches_consumed":{"description":"Batches actually consumed, capped by `budget`.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.batches_consumed","typeLabel":"integer\u003cint64>"},"facts_distilled":{"description":"Facts extracted from the consumed batches.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.facts_distilled","typeLabel":"integer\u003cint64>"},"facts_added":{"description":"Distilled facts that were new.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.facts_added","typeLabel":"integer\u003cint64>"},"facts_merged":{"description":"Distilled facts folded into a fact already held.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.facts_merged","typeLabel":"integer\u003cint64>"},"facts_dropped_untyped":{"description":"Facts discarded because they matched no declared artifact type.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.facts_dropped_untyped","typeLabel":"integer\u003cint64>"},"edges_added":{"description":"New relationships recorded between artifacts.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.edges_added","typeLabel":"integer\u003cint64>"},"artifacts_pruned":{"description":"Artifacts removed as superseded.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.artifacts_pruned","typeLabel":"integer\u003cint64>"},"artifact_files_written":{"description":"How many were written.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.artifact_files_written","typeLabel":"integer\u003cint64>"},"artifact_files_deleted":{"description":"How many were removed.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.artifact_files_deleted","typeLabel":"integer\u003cint64>"},"artifact_count":{"description":"Artifacts the context holds after the run.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.artifact_count","typeLabel":"integer\u003cint64>"},"artifact_bytes":{"description":"Total artifact size after the run.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.artifact_bytes","typeLabel":"integer\u003cint64>"},"duration_ms":{"description":"Wall time for the groom.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.9.duration_ms","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output.oneOf.9","typeLabel":"Groom · object"},{"type":"object","title":"Curate run","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","flipped","versioned","mode","scope","images_skipped_no_vision","sources_skipped_unreadable","usage","sample_queries","delta"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.status","typeLabel":"string"},"flipped":{"description":"Whether the new index version was made live. False means queries still read the previous one.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.10.flipped","typeLabel":"boolean"},"versioned":{"description":"Whether the run wrote version stamps.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.10.versioned","typeLabel":"boolean"},"mode":{"description":"Set to `incremental` when the context has a manifest, `full` otherwise.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.mode","typeLabel":"string"},"scope":{"description":"What the run covered, e.g. `full` or `reconcile`.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.scope","typeLabel":"string"},"images_skipped_no_vision":{"description":"Images left unread because the configured model cannot see.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.images_skipped_no_vision","typeLabel":"integer\u003cint64>"},"sources_skipped_unreadable":{"description":"Sources no leg could read, skipped rather than failed.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.sources_skipped_unreadable","typeLabel":"integer\u003cint64>"},"usage":{"description":"Curate's token rollup: the chat-seam totals plus the embed/rerank seam (`embed_by_model`). It does not carry the cache-token fields.","type":"object","properties":{"prompt_tokens":{"description":"Input tokens billed on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.completion_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.total_tokens","typeLabel":"integer\u003cint64>"},"by_model":{"description":"Chat-seam counts keyed by the model the proxy actually dispatched to.","type":"object","additionalProperties":{"description":"Per-model chat-seam counts; both usage roll-ups write every key.","type":"object","properties":{"tier":{"description":"Which tier resolved to this model, so a tier fallback is visible.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.tier","typeLabel":"string"},"prompt_tokens":{"description":"Input tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.completion_tokens","typeLabel":"integer\u003cint64>"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.cache_write_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens for this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties.total_tokens","typeLabel":"integer\u003cint64>"}},"required":["tier","prompt_tokens","completion_tokens","cache_read_tokens","cache_write_tokens","total_tokens"],"uniqueKey":"output.oneOf.10.usage.by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.10.usage.by_model","typeLabel":"object"},"embed_by_model":{"description":"Embed and rerank counts keyed by model. These bill separately from the chat totals above and are not included in them.","type":"object","additionalProperties":{"description":"Per-model embed/rerank-seam counts: billed per token (embed) or per request (rerank).","type":"object","properties":{"kind":{"description":"Which seam this row counts, and therefore which of the two count fields is meaningful.","x-enum":["embed","rerank"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.usage.embed_by_model.additionalProperties.kind","typeLabel":"string"},"tier":{"description":"Which tier resolved to this model.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.usage.embed_by_model.additionalProperties.tier","typeLabel":"string"},"embed_tokens":{"description":"Tokens embedded. Meaningful for `kind: embed`.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.embed_by_model.additionalProperties.embed_tokens","typeLabel":"integer\u003cint64>"},"rerank_units":{"description":"Rerank requests made. Meaningful for `kind: rerank`.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.usage.embed_by_model.additionalProperties.rerank_units","typeLabel":"integer\u003cint64>"}},"required":["kind","tier","embed_tokens","rerank_units"],"uniqueKey":"output.oneOf.10.usage.embed_by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.10.usage.embed_by_model","typeLabel":"object"}},"required":["prompt_tokens","completion_tokens","total_tokens","by_model","embed_by_model"],"isRequired":true,"uniqueKey":"output.oneOf.10.usage","typeLabel":"object"},"sample_queries":{"description":"Example questions the corpus can answer","type":"array","items":{"description":"One example question.","type":"string","uniqueKey":"output.oneOf.10.sample_queries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.10.sample_queries","typeLabel":"string[]"},"delta":{"description":"What the run changed, counted per leg.","type":"object","properties":{"new":{"description":"Sources not seen by a previous curate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.new","typeLabel":"integer\u003cint64>"},"changed":{"description":"Sources whose content hash moved.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.changed","typeLabel":"integer\u003cint64>"},"deleted":{"description":"Sources dropped from the index.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.deleted","typeLabel":"integer\u003cint64>"},"processed":{"description":"Sources the run actually read.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.processed","typeLabel":"integer\u003cint64>"},"failed":{"description":"Sources that could not be curated.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.failed","typeLabel":"integer\u003cint64>"},"failed_sources":{"description":"Paths of the failed sources, capped in length.","type":"array","items":{"description":"A source path that failed.","type":"string","uniqueKey":"output.oneOf.10.delta.failed_sources.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.10.delta.failed_sources","typeLabel":"string[]"},"failed_sources_truncated":{"description":"Whether failed_sources was capped and the full list spilled to a file","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.10.delta.failed_sources_truncated","typeLabel":"boolean"},"failed_sources_file":{"description":"Where the full failed-sources list was written when truncated","type":"string","isRequired":true,"uniqueKey":"output.oneOf.10.delta.failed_sources_file","typeLabel":"string"},"corpus_artifacts":{"description":"Artifacts written by the corpus-wide reduce pass.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.corpus_artifacts","typeLabel":"integer\u003cint64>"},"corpus_edges":{"description":"Edges written by that pass.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.corpus_edges","typeLabel":"integer\u003cint64>"},"corpus_artifacts_screened":{"description":"Corpus artifacts rejected by the quality screen.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.corpus_artifacts_screened","typeLabel":"integer\u003cint64>"},"screened":{"description":"Sum of the per-leg and corpus screen counts","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.screened","typeLabel":"integer\u003cint64>"},"chunks_created":{"description":"Chunks written for the first time.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.chunks_created","typeLabel":"integer\u003cint64>"},"chunks_updated":{"description":"Chunks rewritten from changed sources.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.chunks_updated","typeLabel":"integer\u003cint64>"},"artifacts_created":{"description":"Per-document artifacts written for the first time.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.artifacts_created","typeLabel":"integer\u003cint64>"},"artifacts_updated":{"description":"Per-document artifacts rewritten from changed sources.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.artifacts_updated","typeLabel":"integer\u003cint64>"},"chunks_screened":{"description":"Chunks rejected by the quality screen.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.chunks_screened","typeLabel":"integer\u003cint64>"},"artifacts_screened":{"description":"Per-document artifacts rejected by the quality screen.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.artifacts_screened","typeLabel":"integer\u003cint64>"},"images_skipped_no_vision":{"description":"Images left unread because the configured model cannot see.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.images_skipped_no_vision","typeLabel":"integer\u003cint64>"},"sources_skipped_unreadable":{"description":"Sources no leg could read, skipped rather than failed.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.sources_skipped_unreadable","typeLabel":"integer\u003cint64>"},"artifacts_errored":{"description":"Extraction calls that failed outright.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.artifacts_errored","typeLabel":"integer\u003cint64>"},"sources_content_truncated":{"description":"Sources whose text was cut at the input cap, so their tail went unread.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.10.delta.sources_content_truncated","typeLabel":"integer\u003cint64>"}},"required":["new","changed","deleted","processed","failed","failed_sources","failed_sources_truncated","failed_sources_file","corpus_artifacts","corpus_edges","corpus_artifacts_screened","screened","chunks_created","chunks_updated","artifacts_created","artifacts_updated","chunks_screened","artifacts_screened","images_skipped_no_vision","sources_skipped_unreadable","artifacts_errored","sources_content_truncated"],"isRequired":true,"uniqueKey":"output.oneOf.10.delta","typeLabel":"object"}},"uniqueKey":"output.oneOf.10","typeLabel":"Curate run · object"},{"type":"object","title":"Curate manifest_tune","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","flipped","versioned","mode","usage","delta"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.status","typeLabel":"string"},"flipped":{"description":"Always false — the run targets optimize trial namespaces, not the live index.","x-enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.11.flipped","typeLabel":"boolean"},"versioned":{"description":"Whether the run wrote version stamps.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.11.versioned","typeLabel":"boolean"},"mode":{"description":"Always `manifest_tune`.","x-enum":["manifest_tune"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.mode","typeLabel":"string"},"usage":{"description":"Curate's token rollup: the chat-seam totals plus the embed/rerank seam (`embed_by_model`). It does not carry the cache-token fields.","type":"object","properties":{"prompt_tokens":{"description":"Input tokens billed on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.completion_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens on the chat seam.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.total_tokens","typeLabel":"integer\u003cint64>"},"by_model":{"description":"Chat-seam counts keyed by the model the proxy actually dispatched to.","type":"object","additionalProperties":{"description":"Per-model chat-seam counts; both usage roll-ups write every key.","type":"object","properties":{"tier":{"description":"Which tier resolved to this model, so a tier fallback is visible.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.tier","typeLabel":"string"},"prompt_tokens":{"description":"Input tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.completion_tokens","typeLabel":"integer\u003cint64>"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.cache_write_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens for this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties.total_tokens","typeLabel":"integer\u003cint64>"}},"required":["tier","prompt_tokens","completion_tokens","cache_read_tokens","cache_write_tokens","total_tokens"],"uniqueKey":"output.oneOf.11.usage.by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.11.usage.by_model","typeLabel":"object"},"embed_by_model":{"description":"Embed and rerank counts keyed by model. These bill separately from the chat totals above and are not included in them.","type":"object","additionalProperties":{"description":"Per-model embed/rerank-seam counts: billed per token (embed) or per request (rerank).","type":"object","properties":{"kind":{"description":"Which seam this row counts, and therefore which of the two count fields is meaningful.","x-enum":["embed","rerank"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.usage.embed_by_model.additionalProperties.kind","typeLabel":"string"},"tier":{"description":"Which tier resolved to this model.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.usage.embed_by_model.additionalProperties.tier","typeLabel":"string"},"embed_tokens":{"description":"Tokens embedded. Meaningful for `kind: embed`.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.embed_by_model.additionalProperties.embed_tokens","typeLabel":"integer\u003cint64>"},"rerank_units":{"description":"Rerank requests made. Meaningful for `kind: rerank`.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.usage.embed_by_model.additionalProperties.rerank_units","typeLabel":"integer\u003cint64>"}},"required":["kind","tier","embed_tokens","rerank_units"],"uniqueKey":"output.oneOf.11.usage.embed_by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.11.usage.embed_by_model","typeLabel":"object"}},"required":["prompt_tokens","completion_tokens","total_tokens","by_model","embed_by_model"],"isRequired":true,"uniqueKey":"output.oneOf.11.usage","typeLabel":"object"},"delta":{"description":"What the re-eval changed.","type":"object","properties":{"artifacts_reevaluated":{"description":"Artifacts re-extracted under the tuned manifest. Replaces the source counts a normal run reports.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.artifacts_reevaluated","typeLabel":"integer\u003cint64>"},"failed":{"description":"Sources that could not be re-evaluated.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.failed","typeLabel":"integer\u003cint64>"},"failed_sources":{"description":"Paths of the failed sources, capped in length.","type":"array","items":{"description":"A source path that failed.","type":"string","uniqueKey":"output.oneOf.11.delta.failed_sources.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.11.delta.failed_sources","typeLabel":"string[]"},"failed_sources_truncated":{"description":"Whether failed_sources was capped and the full list spilled to a file.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.11.delta.failed_sources_truncated","typeLabel":"boolean"},"failed_sources_file":{"description":"Where the full failed-sources list was written when truncated.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.11.delta.failed_sources_file","typeLabel":"string"},"corpus_artifacts":{"description":"Artifacts written by the corpus-wide reduce pass.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.corpus_artifacts","typeLabel":"integer\u003cint64>"},"corpus_edges":{"description":"Edges written by that pass.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.corpus_edges","typeLabel":"integer\u003cint64>"},"chunks_created":{"description":"Chunks written for the first time.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.chunks_created","typeLabel":"integer\u003cint64>"},"chunks_updated":{"description":"Chunks rewritten from changed sources.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.chunks_updated","typeLabel":"integer\u003cint64>"},"artifacts_created":{"description":"Per-document artifacts written for the first time.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.artifacts_created","typeLabel":"integer\u003cint64>"},"artifacts_updated":{"description":"Per-document artifacts rewritten from changed sources.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.artifacts_updated","typeLabel":"integer\u003cint64>"},"chunks_screened":{"description":"Chunks rejected by the quality screen.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.chunks_screened","typeLabel":"integer\u003cint64>"},"artifacts_screened":{"description":"Per-document artifacts rejected by the quality screen.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.artifacts_screened","typeLabel":"integer\u003cint64>"},"images_skipped_no_vision":{"description":"Images left unread because the configured model cannot see.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.images_skipped_no_vision","typeLabel":"integer\u003cint64>"},"sources_skipped_unreadable":{"description":"Sources no leg could read, skipped rather than failed.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.sources_skipped_unreadable","typeLabel":"integer\u003cint64>"},"artifacts_errored":{"description":"Extraction calls that failed outright.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.artifacts_errored","typeLabel":"integer\u003cint64>"},"sources_content_truncated":{"description":"Sources whose text was cut at the input cap.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.11.delta.sources_content_truncated","typeLabel":"integer\u003cint64>"}},"required":["artifacts_reevaluated","failed","failed_sources","failed_sources_truncated","failed_sources_file","corpus_artifacts","corpus_edges","chunks_created","chunks_updated","artifacts_created","artifacts_updated","chunks_screened","artifacts_screened","images_skipped_no_vision","sources_skipped_unreadable","artifacts_errored","sources_content_truncated"],"isRequired":true,"uniqueKey":"output.oneOf.11.delta","typeLabel":"object"}},"uniqueKey":"output.oneOf.11","typeLabel":"Curate manifest_tune · object"},{"type":"object","title":"Curate no-op","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","flipped","versioned","mode","scope","delta"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.12.status","typeLabel":"string"},"flipped":{"description":"Whether a new index version was made live.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.12.flipped","typeLabel":"boolean"},"versioned":{"description":"Whether the run wrote version stamps.","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.12.versioned","typeLabel":"boolean"},"mode":{"description":"Set to `incremental` when the context has a manifest, `full` otherwise.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.12.mode","typeLabel":"string"},"scope":{"description":"What the run would have covered.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.12.scope","typeLabel":"string"},"delta":{"description":"Always the literal string `empty`.","x-enum":["empty"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.12.delta","typeLabel":"string"}},"uniqueKey":"output.oneOf.12","typeLabel":"Curate no-op · object"},{"type":"object","title":"Explore","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","matches","none","guide","models","usage"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.13.status","typeLabel":"string"},"matches":{"description":"Validated template recommendations; unknown or low-confidence proposals are dropped upstream.","type":"array","items":{"description":"One manifest template an explore run proposes for the corpus.","type":"object","properties":{"template_id":{"description":"Catalog entry the run proposes for this corpus.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.13.matches.items.[INDEX].template_id","typeLabel":"string"},"rationale":{"description":"Why the run thinks this template fits the corpus.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.13.matches.items.[INDEX].rationale","typeLabel":"string"},"confidence":{"description":"How sure the run is, 0–1. Low-confidence proposals are dropped before this point.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.13.matches.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"}},"required":["template_id","rationale","confidence"],"uniqueKey":"output.oneOf.13.matches.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.13.matches","typeLabel":"object[]"},"none":{"description":"True when no template fit","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.13.none","typeLabel":"boolean"},"guide":{"description":"The guidance the proposal was steered with, echoed back.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.13.guide","typeLabel":"string"},"models":{"description":"Tier → resolved model id.","type":"object","additionalProperties":{"description":"The model id the tier resolved to.","type":"string","uniqueKey":"output.oneOf.13.models.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.13.models","typeLabel":"object"},"usage":{"description":"What a run billed on the chat seam, in tokens. Reported by the inference client, which carries the cache-token fields. Used by optimize and explore.","type":"object","properties":{"prompt_tokens":{"description":"Input tokens billed across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.completion_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens across every model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.total_tokens","typeLabel":"integer\u003cint64>"},"by_model":{"description":"Keyed by the model the proxy actually dispatched to, so tier fallbacks are visible.","type":"object","additionalProperties":{"description":"Per-model chat-seam counts; both usage roll-ups write every key.","type":"object","properties":{"tier":{"description":"Which tier resolved to this model, so a tier fallback is visible.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.tier","typeLabel":"string"},"prompt_tokens":{"description":"Input tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.prompt_tokens","typeLabel":"integer\u003cint64>"},"completion_tokens":{"description":"Output tokens billed to this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.completion_tokens","typeLabel":"integer\u003cint64>"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.cache_write_tokens","typeLabel":"integer\u003cint64>"},"total_tokens":{"description":"Input plus output tokens for this model.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties.total_tokens","typeLabel":"integer\u003cint64>"}},"required":["tier","prompt_tokens","completion_tokens","cache_read_tokens","cache_write_tokens","total_tokens"],"uniqueKey":"output.oneOf.13.usage.by_model.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.13.usage.by_model","typeLabel":"object"},"cache_read_tokens":{"description":"Input served without re-billing.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.cache_read_tokens","typeLabel":"integer\u003cint64>"},"cache_write_tokens":{"description":"Prompt tokens written into cache.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.13.usage.cache_write_tokens","typeLabel":"integer\u003cint64>"}},"required":["prompt_tokens","completion_tokens","total_tokens","by_model","cache_read_tokens","cache_write_tokens"],"isRequired":true,"uniqueKey":"output.oneOf.13.usage","typeLabel":"object"},"unknown_models":{"description":"Model selections dropped as unknown before dispatch, so a caller whose pin was silently ignored can see it. Absent when nothing was dropped.","type":"array","items":{"description":"A requested model id or tier name the project's catalog does not carry.","type":"string","uniqueKey":"output.oneOf.13.unknown_models.items.[INDEX]","typeLabel":"string"},"uniqueKey":"output.oneOf.13.unknown_models","typeLabel":"string[]"}},"uniqueKey":"output.oneOf.13","typeLabel":"Explore · object"},{"type":"object","title":"Profile estimate","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","g","density","cost","sampling"],"properties":{"state":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.14.state","typeLabel":"string"},"g":{"description":"Estimated distinct-artifact count with its uncertainty band. This is what drives the cost estimate, since extraction cost scales with it.","type":"object","properties":{"value":{"description":"Point estimate of the distinct-artifact count.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.g.value","typeLabel":"integer\u003cint64>"},"lo":{"description":"Low end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.g.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"High end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.g.hi","typeLabel":"integer\u003cint64>"},"method":{"description":"The estimator the recurrence blend selected; `empty` on the no-sample path","type":"string","isRequired":true,"uniqueKey":"output.oneOf.14.g.method","typeLabel":"string"},"recurrence":{"description":"How often the same subject recurs across sampled documents. Drives which estimator is chosen.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.14.g.recurrence","typeLabel":"number\u003cdouble>"},"confidence":{"description":"Qualitative confidence in the estimate.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.14.g.confidence","typeLabel":"string"},"note":{"description":"Caveat on how to read the estimate.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.14.g.note","typeLabel":"string"}},"required":["value","lo","hi","method","recurrence","confidence","note"],"isRequired":true,"uniqueKey":"output.oneOf.14.g","typeLabel":"object"},"density":{"description":"Measured on the sampling window, not the full curate read-depth.","type":"object","properties":{"entities_per_doc":{"description":"Mean distinct subjects found per sampled document.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.14.density.entities_per_doc","typeLabel":"number\u003cdouble>"},"avg_doc_chars":{"description":"Mean source length in characters.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.density.avg_doc_chars","typeLabel":"integer\u003cint64>"}},"required":["entities_per_doc","avg_doc_chars"],"isRequired":true,"uniqueKey":"output.oneOf.14.density","typeLabel":"object"},"cost":{"description":"Estimated token and time cost of the curate, one estimate per model tier.","type":"object","properties":{"by_tier":{"description":"One estimate per model tier.","type":"object","properties":{"lite":{"description":"What the curate would cost at one model tier.","type":"object","properties":{"tokens":{"description":"The `point` estimate sits at G's midpoint and splits into input/output; `lo`/`hi` are band totals.","type":"object","properties":{"point":{"description":"Estimate at the artifact count's midpoint.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens.point","typeLabel":"integer\u003cint64>"},"lo":{"description":"Total at the low end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"Total at the high end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens.hi","typeLabel":"integer\u003cint64>"},"input":{"description":"Input share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens.input","typeLabel":"integer\u003cint64>"},"output":{"description":"Output share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens.output","typeLabel":"integer\u003cint64>"}},"required":["point","lo","hi","input","output"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.tokens","typeLabel":"object"},"time_s":{"description":"Estimated wall-clock band for the curate, in seconds.","type":"object","properties":{"lo":{"description":"Low end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.time_s.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"High end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.time_s.hi","typeLabel":"integer\u003cint64>"}},"required":["lo","hi"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite.time_s","typeLabel":"object"}},"required":["tokens","time_s"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.lite","typeLabel":"object"},"standard":{"description":"What the curate would cost at one model tier.","type":"object","properties":{"tokens":{"description":"The `point` estimate sits at G's midpoint and splits into input/output; `lo`/`hi` are band totals.","type":"object","properties":{"point":{"description":"Estimate at the artifact count's midpoint.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens.point","typeLabel":"integer\u003cint64>"},"lo":{"description":"Total at the low end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"Total at the high end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens.hi","typeLabel":"integer\u003cint64>"},"input":{"description":"Input share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens.input","typeLabel":"integer\u003cint64>"},"output":{"description":"Output share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens.output","typeLabel":"integer\u003cint64>"}},"required":["point","lo","hi","input","output"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.tokens","typeLabel":"object"},"time_s":{"description":"Estimated wall-clock band for the curate, in seconds.","type":"object","properties":{"lo":{"description":"Low end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.time_s.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"High end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.time_s.hi","typeLabel":"integer\u003cint64>"}},"required":["lo","hi"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard.time_s","typeLabel":"object"}},"required":["tokens","time_s"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.standard","typeLabel":"object"},"pro":{"description":"What the curate would cost at one model tier.","type":"object","properties":{"tokens":{"description":"The `point` estimate sits at G's midpoint and splits into input/output; `lo`/`hi` are band totals.","type":"object","properties":{"point":{"description":"Estimate at the artifact count's midpoint.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens.point","typeLabel":"integer\u003cint64>"},"lo":{"description":"Total at the low end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"Total at the high end of the band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens.hi","typeLabel":"integer\u003cint64>"},"input":{"description":"Input share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens.input","typeLabel":"integer\u003cint64>"},"output":{"description":"Output share of the point estimate.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens.output","typeLabel":"integer\u003cint64>"}},"required":["point","lo","hi","input","output"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.tokens","typeLabel":"object"},"time_s":{"description":"Estimated wall-clock band for the curate, in seconds.","type":"object","properties":{"lo":{"description":"Low end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.time_s.lo","typeLabel":"integer\u003cint64>"},"hi":{"description":"High end of the wall-clock band.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.time_s.hi","typeLabel":"integer\u003cint64>"}},"required":["lo","hi"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro.time_s","typeLabel":"object"}},"required":["tokens","time_s"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier.pro","typeLabel":"object"}},"required":["lite","standard","pro"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost.by_tier","typeLabel":"object"},"default_tier":{"description":"The tier the context's current `artifact_model` resolves to","type":"string","isRequired":true,"uniqueKey":"output.oneOf.14.cost.default_tier","typeLabel":"string"}},"required":["by_tier","default_tier"],"isRequired":true,"uniqueKey":"output.oneOf.14.cost","typeLabel":"object"},"sampling":{"description":"How much of the corpus the profile actually read. The estimate is extrapolated from this much, so a small `fraction` means a wide band.","type":"object","properties":{"n_total":{"description":"Sources in the corpus.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.sampling.n_total","typeLabel":"integer\u003cint64>"},"n_sampled":{"description":"Sources the profile read.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.14.sampling.n_sampled","typeLabel":"integer\u003cint64>"},"fraction":{"description":"The `n_sampled` count over `n_total`.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.14.sampling.fraction","typeLabel":"number\u003cdouble>"},"wall_s":{"description":"Seconds the sampling itself took.","type":"number","format":"double","isRequired":true,"uniqueKey":"output.oneOf.14.sampling.wall_s","typeLabel":"number\u003cdouble>"}},"required":["n_total","n_sampled","fraction","wall_s"],"isRequired":true,"uniqueKey":"output.oneOf.14.sampling","typeLabel":"object"}},"uniqueKey":"output.oneOf.14","typeLabel":"Profile estimate · object"},{"type":"object","title":"Profile empty","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","reason"],"properties":{"state":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.15.state","typeLabel":"string"},"reason":{"description":"Why no estimate could be made.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.15.reason","typeLabel":"string"}},"uniqueKey":"output.oneOf.15","typeLabel":"Profile empty · object"},{"type":"object","title":"Import","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","imported_items","output_files","failed","skipped","skipped_items","manifest_sample","manifest_truncated","manifest_file"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.status","typeLabel":"string"},"imported_items":{"description":"Records pulled from the provider.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.imported_items","typeLabel":"integer\u003cint64>"},"output_files":{"description":"Files written into the source tree. Higher than `imported_items` when archives or multi-page documents expanded.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.output_files","typeLabel":"integer\u003cint64>"},"failed":{"description":"Records that could not be ingested.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.failed","typeLabel":"integer\u003cint64>"},"skipped":{"description":"Records passed over, e.g. an unsupported extension or a cap already reached.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.skipped","typeLabel":"integer\u003cint64>"},"skipped_items":{"description":"Bounded sample of the skipped records","type":"array","items":{"description":"One ingest record — what happened to a single source the import saw.","type":"object","properties":{"src":{"description":"The record at the provider.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].src","typeLabel":"string"},"action":{"description":"What happened to the record. `parsed` converted the file to text, `copied` took it as-is, `extracted` expanded an archive.","x-enum":["parsed","copied","extracted","skipped","failed"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].action","typeLabel":"string"},"out":{"description":"Empty exactly when nothing was written","type":"array","items":{"description":"A path written into the source tree.","type":"string","uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].out.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].out","typeLabel":"string[]"},"fmt":{"description":"Format the ingester recognized.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].fmt","typeLabel":"string"},"reason":{"description":"Why it was skipped or how it failed. Empty on success.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].reason","typeLabel":"string"},"bytes":{"description":"Bytes written for this record.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX].bytes","typeLabel":"integer\u003cint64>"}},"required":["src","action","out","fmt","reason","bytes"],"uniqueKey":"output.oneOf.16.skipped_items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.16.skipped_items","typeLabel":"object[]"},"manifest_sample":{"description":"Bounded sample of the records that produced output","type":"array","items":{"description":"One ingest record — what happened to a single source the import saw.","type":"object","properties":{"src":{"description":"The record at the provider.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].src","typeLabel":"string"},"action":{"description":"What happened to the record. `parsed` converted the file to text, `copied` took it as-is, `extracted` expanded an archive.","x-enum":["parsed","copied","extracted","skipped","failed"],"type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].action","typeLabel":"string"},"out":{"description":"Empty exactly when nothing was written","type":"array","items":{"description":"A path written into the source tree.","type":"string","uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].out.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].out","typeLabel":"string[]"},"fmt":{"description":"Format the ingester recognized.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].fmt","typeLabel":"string"},"reason":{"description":"Why it was skipped or how it failed. Empty on success.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].reason","typeLabel":"string"},"bytes":{"description":"Bytes written for this record.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX].bytes","typeLabel":"integer\u003cint64>"}},"required":["src","action","out","fmt","reason","bytes"],"uniqueKey":"output.oneOf.16.manifest_sample.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"output.oneOf.16.manifest_sample","typeLabel":"object[]"},"manifest_truncated":{"description":"Whether either sample was cut","type":"boolean","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_truncated","typeLabel":"boolean"},"manifest_file":{"description":"Where the full manifest was written","type":"string","isRequired":true,"uniqueKey":"output.oneOf.16.manifest_file","typeLabel":"string"},"manifest_object":{"description":"Object-store key of the full manifest","type":"string","uniqueKey":"output.oneOf.16.manifest_object","typeLabel":"string"}},"uniqueKey":"output.oneOf.16","typeLabel":"Import · object"},{"type":"object","title":"Status-keyed failure","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["status","error"],"properties":{"status":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.17.status","typeLabel":"string"},"error":{"description":"What went wrong.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.17.error","typeLabel":"string"}},"uniqueKey":"output.oneOf.17","typeLabel":"Status-keyed failure · object"},{"type":"object","title":"State-keyed failure","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["state","error"],"properties":{"state":{"description":"How the run ended.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.18.state","typeLabel":"string"},"error":{"description":"What went wrong.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.18.error","typeLabel":"string"}},"uniqueKey":"output.oneOf.18","typeLabel":"State-keyed failure · object"},{"type":"object","title":"API-written failure","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","required":["error"],"properties":{"error":{"description":"What went wrong.","type":"string","isRequired":true,"uniqueKey":"output.oneOf.19.error","typeLabel":"string"}},"uniqueKey":"output.oneOf.19","typeLabel":"API-written failure · object"},{"type":"object","title":"Other","description":"A task's reported `output`. Every workflow reports a different per-state shape, matched to a named variant only when its key set is exactly that variant's; anything else is preserved as stored. Treat this union as open. Null until the run reports anything.","additionalProperties":true,"uniqueKey":"output.oneOf.20","typeLabel":"Other · object"},{"type":"null","uniqueKey":"output.oneOf.21","typeLabel":"null"}],"uniqueKey":"output","typeLabel":"Search / search_rag completed · object | Search-as-code completed · object | Search failed · object | Pack running · object | Pack completed · object | Restore running · object | Restore completed · object | Optimize result · object | Optimize no-op · object | Groom · object | Curate run · object | Curate manifest_tune · object | Curate no-op · object | Explore · object | Profile estimate · object | Profile empty · object | Import · object | Status-keyed failure · object | State-keyed failure · object | API-written failure · object | Other · object | null"},"steps_total":{"description":"True number of recorded steps. Absent on a read that carries no steps.","type":"integer","format":"int64","uniqueKey":"steps_total","typeLabel":"integer\u003cint64>"},"running_from":{"oneOf":[{"description":"When the container started. Null before it does.","type":"string","format":"date-time","uniqueKey":"running_from.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the container started. Null before it does.","type":"null","format":"date-time","uniqueKey":"running_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"running_from","typeLabel":"string\u003cdate-time> | null"},"timeout_seconds":{"oneOf":[{"description":"Runtime budget for this task. Null when it runs uncapped.","type":"integer","uniqueKey":"timeout_seconds.oneOf.0","typeLabel":"integer"},{"description":"Runtime budget for this task. Null when it runs uncapped.","type":"null","uniqueKey":"timeout_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"timeout_seconds","typeLabel":"integer | null"},"timeout_at":{"oneOf":[{"description":"When the budget expires and the run is terminated.","type":"string","format":"date-time","uniqueKey":"timeout_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the budget expires and the run is terminated.","type":"null","format":"date-time","uniqueKey":"timeout_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"timeout_at","typeLabel":"string\u003cdate-time> | null"},"archived_at":{"oneOf":[{"description":"When the task's files were archived. Null while they are still live.","type":"string","format":"date-time","uniqueKey":"archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the task's files were archived. Null while they are still live.","type":"null","format":"date-time","uniqueKey":"archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"archived_at","typeLabel":"string\u003cdate-time> | null"},"last_activity_at":{"oneOf":[{"description":"When the runtime last reported anything. Drives stall detection.","type":"string","format":"date-time","uniqueKey":"last_activity_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the runtime last reported anything. Drives stall detection.","type":"null","format":"date-time","uniqueKey":"last_activity_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_activity_at","typeLabel":"string\u003cdate-time> | null"},"schedule":{"oneOf":[{"description":"Cron expression this run was scheduled from. Null for an on-demand run.","type":"string","uniqueKey":"schedule.oneOf.0","typeLabel":"string"},{"description":"Cron expression this run was scheduled from. Null for an on-demand run.","type":"null","uniqueKey":"schedule.oneOf.1","typeLabel":"null"}],"uniqueKey":"schedule","typeLabel":"string | null"},"scheduled_at":{"oneOf":[{"description":"When a `scheduled` task is due to start.","type":"string","format":"date-time","uniqueKey":"scheduled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When a `scheduled` task is due to start.","type":"null","format":"date-time","uniqueKey":"scheduled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"scheduled_at","typeLabel":"string\u003cdate-time> | null"},"parent_task_id":{"oneOf":[{"description":"The task that spawned this one, as an optimize spawns its curates.","type":"string","uniqueKey":"parent_task_id.oneOf.0","typeLabel":"string"},{"description":"The task that spawned this one, as an optimize spawns its curates.","type":"null","uniqueKey":"parent_task_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"parent_task_id","typeLabel":"string | null"},"progress":{"description":"Coarse run progress, written by the runtime. Absent on a task that reports none.","type":"object","properties":{"phase":{"description":"1-based index of the phase now running.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"progress.phase","typeLabel":"integer\u003cint64>"},"phases":{"description":"Total phases this run expects.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"progress.phases","typeLabel":"integer\u003cint64>"},"label":{"description":"What the current phase is doing.","type":"string","isRequired":true,"uniqueKey":"progress.label","typeLabel":"string"},"pct":{"description":"Completion across the whole run, 0–100.","type":"number","format":"double","isRequired":true,"uniqueKey":"progress.pct","typeLabel":"number\u003cdouble>"},"eta_seconds":{"oneOf":[{"description":"Estimated seconds remaining. Null when the run cannot estimate one.","type":"integer","format":"int64","uniqueKey":"progress.eta_seconds.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Estimated seconds remaining. Null when the run cannot estimate one.","type":"null","format":"int64","uniqueKey":"progress.eta_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"progress.eta_seconds","typeLabel":"integer\u003cint64> | null"}},"required":["phase","phases","label","pct"],"uniqueKey":"progress","typeLabel":"object"}},"required":["id","project_id","created_by","workflow","state","input","steps","tokens_prompt","tokens_completion","runtime_seconds","created_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","project_id":"\u003cstring>","created_by":"\u003cstring>","workflow":"\u003cstring>","state":"\u003cstring>","input":{"session_id":"\u003cstring>","query_id":"\u003cstring>","ask":"\u003cstring>","messages":[{"role":"\u003cstring>","content":"\u003cstring>"}],"models":["\u003cstring>"],"tools":["\u003cstring>"],"shape":{},"instructions":"\u003cstring>","scope":["\u003cstring>"],"turn_timeout_seconds":123,"comparison_group":"\u003cstring>","retrieval":{"retrieval_only":true,"pointers_only":true,"chunks_only":true,"artifacts_only":true,"max_retrieved":123,"max_retrieved_chars":123,"compose":true,"max_steps":123,"thinking_level":"\u003cstring>"}},"steps":[{"step_id":"\u003cstring>","status":"\u003cstring>","type":"\u003cstring>","content":"\u003cstring>","commentary":"\u003cstring>","code":"\u003cstring>","result":"\u003cstring>","cum_input_tokens":123,"cum_output_tokens":123,"job_id":"\u003cstring>","path":"\u003cstring>"}],"tokens_prompt":123,"tokens_completion":123,"runtime_seconds":123,"created_at":"2023-11-07T05:31:56Z","context_id":"\u003cstring>","agent_id":"\u003cstring>","session_id":"\u003cstring>","error":"\u003cstring>","output":{"status":"\u003cstring>","query_id":"\u003cstring>","answer":"\u003cstring>","citations":["\u003cstring>"],"latency_ms":123,"output_json":{},"unknown_models":["\u003cstring>"]},"steps_total":123,"running_from":"2023-11-07T05:31:56Z","timeout_seconds":123,"timeout_at":"2023-11-07T05:31:56Z","archived_at":"2023-11-07T05:31:56Z","last_activity_at":"2023-11-07T05:31:56Z","schedule":"\u003cstring>","scheduled_at":"2023-11-07T05:31:56Z","parent_task_id":"\u003cstring>","progress":{"phase":123,"phases":123,"label":"\u003cstring>","pct":123,"eta_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"99b9ed51-9b93-4eba-9e53-dd6678108b50":{"description":"Not found","content":{"application/json":{"schema":{"description":"The error envelope every non-2xx response uses.","type":"object","properties":{"message":{"description":"Human-readable explanation. Not stable — branch on `code`, not on this.","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"Stable machine-readable code, present only on errors a client must branch on. ","x-enum":["unsupported_api_version","preview_not_enabled","preview_file_limit","preview_byte_limit","workspace_host_required","workspace_not_found"],"type":"string","uniqueKey":"code","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"35448661-e633-4a7f-a97e-2147e7209c4f":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Session token from `POST /auth/login`, sent as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"}},"1698663c-2d06-4827-adad-c1bb4f6c0e85":{"apiKey":{"type":"apiKey","in":"header","name":"Api-Key","description":"Pinecone API key, accepted as an alternative to the bearer token.","scopes":[],"schemeName":"apiKey"}}},"servers":{"05a65f99-f0f5-4cc6-bfe4-7306774cd220":{"url":"https://{host}/api","description":"Your Nexus deployment host","variables":{"host":{"default":"api.example.com","description":"Host of your Nexus deployment."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Session token from `POST /auth/login`, sent as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Session token from `POST /auth/login`, sent as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Api-Key","description":"Pinecone API key, accepted as an alternative to the bearer token.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Api-Key","type":"string","description":"Pinecone API key, accepted as an alternative to the bearer token.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"Api-Key"}],"title":"apiKey"}]},"originalFileLocation":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml"},"subdomain":"pinecone","siteName":"Pinecone Docs","title":"Get a task (with steps) - Pinecone Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T16:27:03.420Z","originalFileLocation":"api-reference/tasks/get-a-task-with-steps.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Unlike the listing, this carries the task\u0026#x27;s steps — every one by default, or the newest N with steps_limit, where steps_total reports the true count.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pinecone Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a task (with steps) - Pinecone Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Unlike the listing, this carries the task\u0026#x27;s steps — every one by default, or the newest N with steps_limit, where steps_total reports the true count.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pinecone Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.pinecone.io/images/docs_og_image_v2.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=\"Documentation for the trusted AI knowledge platform | Pinecone\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Guides, API references, and examples for building with Pinecone Database, Pinecone Assistant, and Pinecone Nexus.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.pinecone.io/images/docs_og_image_v2.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=\"/mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pinecone Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#002BFF\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"woTBImNAcYO-gseVfFKIzQrDRUmLWzFjBWrYbYkOTlI\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tasks/get-a-task-with-steps.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pinecone.io/#organization\",\"name\":\"Pinecone Docs\",\"url\":\"https://docs.pinecone.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-Black.svg?fit=max\u0026auto=format\u0026n=HsZKO51bNmpAasdT\u0026q=85\u0026s=211d0e7bbefc29ce3b8feee1a05d76ee\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pinecone.io#website\",\"name\":\"Pinecone Docs\",\"url\":\"https://docs.pinecone.io\",\"publisher\":{\"@id\":\"https://docs.pinecone.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps#webpage\",\"url\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps\",\"name\":\"Get a task (with steps)\",\"description\":\"Unlike the listing, this carries the task's steps — every one by default, or the newest N with steps_limit, where steps_total reports the true count.\",\"dateModified\":\"2026-10-14T16:27:03.420Z\",\"isPartOf\":{\"@id\":\"https://docs.pinecone.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Data plane\",\"item\":\"https://docs.pinecone.io/api-reference/auth/exchange-a-pinecone-api-key-for-a-session-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tasks\",\"item\":\"https://docs.pinecone.io/api-reference/tasks/list-tasks-project-wide-paginated\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a task (with steps)\",\"item\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps#apireference\",\"headline\":\"Get a task (with steps)\",\"name\":\"Get a task (with steps)\",\"description\":\"Unlike the listing, this carries the task's steps — every one by default, or the newest N with steps_limit, where steps_total reports the true count.\",\"url\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pinecone.io/api-reference/tasks/get-a-task-with-steps#webpage\"},\"image\":\"https://www.pinecone.io/images/docs_og_image_v2.png\",\"dateModified\":\"2026-10-14T16:27:03.420Z\",\"publisher\":{\"@id\":\"https://docs.pinecone.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pinecone.io#website\"}}]}\u003c/script>","siteName":"Pinecone Docs","nav":{"global":null,"dropdowns":[{"dropdown":"Pinecone Database","icon":"database","tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Pinecone Database","sidebarTitle":"Overview","mode":"wide","href":"/guides/get-started/overview"},{"group":"Quickstart","pages":[{"title":"Pinecone quickstart","sidebarTitle":"Overview","href":"/guides/get-started/quickstart"},{"title":"Ingest your own files","href":"/guides/get-started/quickstart/ingest-files"},{"title":"Bring your own vectors","href":"/guides/get-started/quickstart/bring-your-own-vectors"},{"title":"Try full-text search","href":"/guides/get-started/quickstart/full-text-search"}]},{"title":"Pinecone key terms","sidebarTitle":"Key terms","href":"/guides/core-concepts/key-terms"},{"title":"Pinecone architecture","sidebarTitle":"Architecture","href":"/guides/core-concepts/architecture"}]},{"group":"Indexes","pages":[{"title":"Index data overview","sidebarTitle":"Overview","href":"/guides/index-data/indexing-overview"},{"group":"Create and configure","pages":[{"title":"Create an index","sidebarTitle":"Create an index","href":"/guides/index-data/create-an-index"},{"title":"Adopt the Documents API","sidebarTitle":"Adopt the Documents API","href":"/guides/index-data/adopt-the-documents-api"},{"title":"Index configuration","sidebarTitle":"Index configuration","href":"/guides/index-data/index-configuration"},{"title":"Configure metadata indexing","href":"/guides/index-data/configure-metadata-indexing"},{"title":"Manage serverless indexes","sidebarTitle":"Manage indexes","href":"/guides/manage-data/manage-indexes"}]},{"title":"Target an index","href":"/guides/manage-data/target-an-index"},{"title":"Data modeling","href":"/guides/index-data/data-modeling"},{"group":"Backups","pages":[{"title":"Backups overview","href":"/guides/manage-data/backups-overview"},{"title":"Back up an index","href":"/guides/manage-data/back-up-an-index"},{"title":"Restore an index","href":"/guides/manage-data/restore-an-index"}]}]},{"group":"Data","pages":[{"group":"Ingestion","pages":[{"title":"Data ingestion overview","sidebarTitle":"Overview","href":"/guides/index-data/data-ingestion-overview"},{"title":"Upsert data","href":"/guides/index-data/upsert-data"},{"title":"Import records","href":"/guides/index-data/import-data"},{"group":"Integrate with cloud storage","pages":[{"title":"Integrate with Amazon S3","icon":"aws","sidebarTitle":"Amazon S3","href":"/guides/operations/integrations/integrate-with-amazon-s3"},{"title":"Integrate with Google Cloud Storage","icon":"google","sidebarTitle":"Google Cloud Storage (GCS)","href":"/guides/operations/integrations/integrate-with-google-cloud-storage"},{"title":"Integrate with Azure Blob Storage","icon":"microsoft","sidebarTitle":"Azure Blob Storage","href":"/guides/operations/integrations/integrate-with-azure-blob-storage"},{"title":"Manage storage integrations","href":"/guides/operations/integrations/manage-storage-integrations"}]},{"title":"Migrate from pgvector","href":"/guides/index-data/migrate-from-pgvector"},{"title":"Check data freshness","href":"/guides/index-data/check-data-freshness"}]},{"group":"Namespaces","pages":[{"title":"Manage namespaces","href":"/guides/manage-data/manage-namespaces"},{"group":"Aliases","pages":[{"title":"Namespace aliases overview","sidebarTitle":"Overview","href":"/guides/manage-data/namespace-aliases/overview"},{"title":"Swap a namespace without downtime","sidebarTitle":"Swap a namespace","href":"/guides/manage-data/namespace-aliases/swap-a-namespace"},{"title":"Manage namespace aliases","sidebarTitle":"Manage aliases","href":"/guides/manage-data/namespace-aliases/manage-aliases"}]}]},{"group":"Multitenancy","pages":[{"title":"Design for multitenancy","sidebarTitle":"Design","href":"/guides/index-data/design-for-multitenancy"},{"title":"Implement multitenancy","sidebarTitle":"Implement","href":"/guides/index-data/implement-multitenancy"}]},{"group":"Documents and records","pages":[{"title":"Fetch data","href":"/guides/manage-data/fetch-data"},{"title":"List IDs","href":"/guides/manage-data/list-record-ids"},{"title":"Update data","href":"/guides/manage-data/update-data"},{"title":"Delete data","href":"/guides/manage-data/delete-data"},{"title":"Manage document chunks","href":"/guides/manage-data/manage-document-chunks"}]}]},{"group":"Search","pages":[{"title":"Search overview","sidebarTitle":"Overview","href":"/guides/search/search-overview"},{"group":"Full-text search","pages":[{"title":"Full-text search overview","sidebarTitle":"Overview","href":"/guides/search/full-text-search"},{"title":"Full-text search query syntax","sidebarTitle":"Query syntax","href":"/guides/search/full-text-search/query-syntax"},{"title":"Full-text search text processing","sidebarTitle":"Text processing","href":"/guides/search/full-text-search/text-processing"}]},{"title":"Semantic search","href":"/guides/search/semantic-search"},{"group":"Hybrid search","pages":[{"title":"Hybrid search overview","sidebarTitle":"Overview","href":"/guides/search/hybrid-search"},{"title":"Run hybrid search on a single index","sidebarTitle":"Use a single index","href":"/guides/search/hybrid-search/single-index"},{"title":"Run hybrid search on separate indexes","sidebarTitle":"Use separate indexes","href":"/guides/search/hybrid-search/separate-indexes"},{"title":"Reciprocal rank fusion","href":"/guides/search/reciprocal-rank-fusion"}]},{"title":"Sparse-vector search","href":"/guides/search/sparse-vector-search"},{"title":"Integrated embedding","href":"/guides/search/integrated-embedding"},{"title":"Filter by metadata","href":"/guides/search/filter-by-metadata"},{"title":"Rerank results","href":"/guides/search/rerank-results"}]},{"group":"Optimize","pages":[{"title":"Increase search relevance","sidebarTitle":"Increase relevance","href":"/guides/optimize/increase-relevance"},{"title":"Diagnose poor search results","href":"/guides/optimize/debug-recall"},{"title":"Increase throughput","href":"/guides/optimize/increase-throughput"},{"title":"Decrease latency","href":"/guides/optimize/decrease-latency"},{"title":"Test Pinecone at scale","sidebarTitle":"Test at scale","href":"/guides/optimize/test-at-scale"},{"group":"Dedicated read nodes","pages":[{"title":"Dedicated read nodes overview","sidebarTitle":"Overview","href":"/guides/index-data/dedicated-read-nodes/overview"},{"title":"Dedicated read nodes concepts","sidebarTitle":"Concepts","href":"/guides/index-data/dedicated-read-nodes/concepts"},{"title":"Create a dedicated read nodes index","sidebarTitle":"Create","href":"/guides/index-data/dedicated-read-nodes/create"},{"title":"Migrate to dedicated read nodes","sidebarTitle":"Migrate","href":"/guides/index-data/dedicated-read-nodes/migrate"},{"title":"Size and test a dedicated read nodes index","sidebarTitle":"Size and test","href":"/guides/index-data/dedicated-read-nodes/size-and-test"},{"title":"Tune queries on dedicated read nodes","sidebarTitle":"Tune queries","href":"/guides/index-data/dedicated-read-nodes/tune-queries"},{"title":"Scale a dedicated read nodes index","sidebarTitle":"Scale","href":"/guides/index-data/dedicated-read-nodes/scale"},{"title":"Manage a dedicated read nodes index","sidebarTitle":"Manage","href":"/guides/index-data/dedicated-read-nodes/manage"}]}]},{"group":"Cost","pages":[{"title":"Understand Pinecone cost","href":"/guides/manage-cost/understanding-cost"},{"title":"Save on Pinecone costs","href":"/guides/manage-cost/save-on-costs"},{"title":"Set monthly spend alerts","href":"/guides/manage-cost/set-spend-alerts"},{"title":"Check usage per request","href":"/guides/manage-cost/check-usage-per-request"},{"title":"Download a usage report","url":"/admin/billing/download-usage-report","href":"/guides/manage-cost/download-usage-report-link"}]},{"group":"Production","pages":[{"title":"Production checklist","sidebarTitle":"Overview","href":"/guides/production/production-checklist"},{"group":"Bring Your Own Cloud (BYOC)","pages":[{"title":"Bring Your Own Cloud (BYOC) overview","sidebarTitle":"Overview","href":"/guides/production/bring-your-own-cloud"},{"title":"Deploy BYOC","sidebarTitle":"Deploy","href":"/guides/production/bring-your-own-cloud/deploy"},{"title":"Create an index in BYOC","sidebarTitle":"Create an index","href":"/guides/production/bring-your-own-cloud/create-an-index"},{"title":"Connect to and manage BYOC","sidebarTitle":"Connect and manage","href":"/guides/production/bring-your-own-cloud/connect-and-manage"}]},{"group":"Data security","pages":[{"title":"Configure customer-managed encryption keys","sidebarTitle":"Configure CMEK","href":"/guides/production/configure-cmek"},{"title":"Configure private endpoints","sidebarTitle":"Configure private endpoints","href":"/guides/production/configure-private-endpoints"},{"title":"Data deletion on Pinecone","sidebarTitle":"Data deletion policy","href":"/guides/production/data-deletion"}]},{"title":"Error handling","href":"/guides/production/error-handling"},{"title":"Mock the Pinecone API for testing","sidebarTitle":"Mock the API for testing","href":"/guides/production/mock-the-api"},{"title":"Monitor performance","href":"/guides/production/monitoring"}]},{"group":"Agents","pages":[{"title":"Use the Pinecone MCP server","sidebarTitle":"MCP server","href":"/guides/operations/mcp-server"},{"title":"Build a knowledge retrieval agent","href":"/guides/operations/build-a-knowledge-agent"}]},{"group":"Pod-based indexes (legacy)","pages":[{"title":"Understanding pod-based indexes","sidebarTitle":"Overview","href":"/guides/indexes/pods/understanding-pod-based-indexes"},{"title":"Migrate a pod-based index to serverless","href":"/guides/indexes/pods/migrate-a-pod-based-index-to-serverless"},{"title":"Choose a pod type and size","sidebarTitle":"Choose a pod type","href":"/guides/indexes/pods/choose-a-pod-type-and-size"},{"title":"Create a pod-based index","href":"/guides/indexes/pods/create-a-pod-based-index"},{"title":"Manage pod-based indexes","href":"/guides/indexes/pods/manage-pod-based-indexes"},{"title":"Scale pod-based indexes","href":"/guides/indexes/pods/scale-pod-based-indexes"},{"group":"Backups","pages":[{"title":"Understanding collections","href":"/guides/indexes/pods/understanding-collections"},{"title":"Back up a pod-based index","href":"/guides/indexes/pods/back-up-a-pod-based-index"},{"title":"Restore a pod-based index","href":"/guides/indexes/pods/restore-a-pod-based-index"}]}]}]},{"tab":"Reference","versions":[{"version":"2026-07 (latest)","default":true,"groups":[{"group":"APIs","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/reference/api/introduction"},{"title":"Pinecone API authentication","sidebarTitle":"Authentication","href":"/reference/api/authentication"},{"title":"Pinecone API versioning","sidebarTitle":"Versioning","href":"/reference/api/versioning"},{"group":"Database limits","pages":[{"title":"Pinecone Database limits overview","sidebarTitle":"Overview","href":"/reference/api/database-limits"},{"title":"Rate limits","sidebarTitle":"Rate limits","href":"/reference/api/database-limits/rate-limits"},{"title":"Object limits","sidebarTitle":"Object limits","href":"/reference/api/database-limits/object-limits"},{"title":"Operation limits","sidebarTitle":"Operation limits","href":"/reference/api/database-limits/operation-limits"},{"title":"Identifier limits","sidebarTitle":"Identifier limits","href":"/reference/api/database-limits/identifier-limits"},{"title":"Known limitations","href":"/reference/api/known-limitations"}]},{"title":"Pinecone API errors","sidebarTitle":"Errors","href":"/reference/api/errors"}]},{"group":"Database","pages":[{"group":"Indexes","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /indexes","title":"List indexes","href":"/reference/api/2026-07/control-plane/list_indexes"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml post /indexes","title":"Create an index","href":"/reference/api/2026-07/control-plane/create_index"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml post /indexes/create-for-model","title":"Create a legacy integrated index","href":"/reference/api/2026-07/control-plane/create_for_model"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /indexes/{index_name}","title":"Describe an index","href":"/reference/api/2026-07/control-plane/describe_index"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml delete /indexes/{index_name}","title":"Delete an index","href":"/reference/api/2026-07/control-plane/delete_index"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml patch /indexes/{index_name}","title":"Configure an index","href":"/reference/api/2026-07/control-plane/configure_index"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /describe_index_stats","title":"Get index stats","href":"/reference/api/2026-07/data-plane/describeindexstats"}]},{"group":"Namespaces","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /namespaces","title":"List namespaces","href":"/reference/api/2026-07/data-plane/listnamespaces"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces","title":"Create a namespace","href":"/reference/api/2026-07/data-plane/createnamespace"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /namespaces/{namespace}","title":"Describe a namespace","href":"/reference/api/2026-07/data-plane/describenamespace"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml delete /namespaces/{namespace}","title":"Delete a namespace","href":"/reference/api/2026-07/data-plane/deletenamespace"}]},{"group":"Namespace aliases","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /namespace-aliases","title":"List namespace aliases","href":"/reference/api/2026-07/data-plane/list_namespace_aliases"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespace-aliases","title":"Create a namespace alias","href":"/reference/api/2026-07/data-plane/create_namespace_alias"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /namespace-aliases/{alias_name}","title":"Describe a namespace alias","href":"/reference/api/2026-07/data-plane/describe_namespace_alias"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml patch /namespace-aliases/{alias_name}","title":"Repoint a namespace alias","href":"/reference/api/2026-07/data-plane/repoint_namespace_alias"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml delete /namespace-aliases/{alias_name}","title":"Delete a namespace alias","href":"/reference/api/2026-07/data-plane/delete_namespace_alias"}]},{"group":"Vectors","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /vectors/upsert","title":"Upsert records","href":"/reference/api/2026-07/data-plane/upsert"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /records/namespaces/{namespace}/upsert","title":"Upsert text (legacy Records API)","href":"/reference/api/2026-07/data-plane/upsert_records"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /vectors/fetch","title":"Fetch records","href":"/reference/api/2026-07/data-plane/fetch"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /vectors/fetch_by_metadata","title":"Fetch records by metadata","href":"/reference/api/2026-07/data-plane/fetch_by_metadata"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /vectors/update","title":"Update a record","href":"/reference/api/2026-07/data-plane/update"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /vectors/delete","title":"Delete records","href":"/reference/api/2026-07/data-plane/delete"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /vectors/list","title":"List record IDs","href":"/reference/api/2026-07/data-plane/list"}]},{"group":"Search","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /query","title":"Search with a vector","href":"/reference/api/2026-07/data-plane/query"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /records/namespaces/{namespace}/search","title":"Search with text (legacy Records API)","href":"/reference/api/2026-07/data-plane/search_records"}]},{"group":"Documents","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/upsert","title":"Upsert documents","href":"/reference/api/2026-07/data-plane/upsert_documents"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/search","title":"Search documents","href":"/reference/api/2026-07/data-plane/search_documents"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/fetch","title":"Fetch documents","href":"/reference/api/2026-07/data-plane/fetch_documents"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/list","title":"List documents","href":"/reference/api/2026-07/data-plane/list_documents"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/update","title":"Update documents","href":"/reference/api/2026-07/data-plane/update_documents"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /namespaces/{namespace}/documents/delete","title":"Delete documents","href":"/reference/api/2026-07/data-plane/delete_documents"}]},{"group":"Imports","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml post /bulk/imports","title":"Start import","href":"/reference/api/2026-07/data-plane/start_import"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /bulk/imports","title":"List imports","href":"/reference/api/2026-07/data-plane/list_imports"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml get /bulk/imports/{id}","title":"Describe an import","href":"/reference/api/2026-07/data-plane/describe_import"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml delete /bulk/imports/{id}","title":"Cancel an import","href":"/reference/api/2026-07/data-plane/cancel_import"}]},{"group":"Backups","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml post /indexes/{index_name}/backups","title":"Create a backup of an index","href":"/reference/api/2026-07/control-plane/create_backup"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /backups","title":"List backups for all indexes in a project","href":"/reference/api/2026-07/control-plane/list_project_backups"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /indexes/{index_name}/backups","title":"List backups for an index","href":"/reference/api/2026-07/control-plane/list_index_backups"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /backups/{backup_id}","title":"Describe a backup","href":"/reference/api/2026-07/control-plane/describe_backup"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml delete /backups/{backup_id}","title":"Delete a backup","href":"/reference/api/2026-07/control-plane/delete_backup"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml post /backups/{backup_id}/create-index","title":"Create an index from a backup","href":"/reference/api/2026-07/control-plane/create_index_from_backup"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /restore-jobs","title":"List restore jobs","href":"/reference/api/2026-07/control-plane/list_restore_jobs"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /restore-jobs/{job_id}","title":"Describe a restore job","href":"/reference/api/2026-07/control-plane/describe_restore_job"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /collections","title":"List collections","href":"/reference/api/2026-07/control-plane/list_collections"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml post /collections","title":"Create a collection","href":"/reference/api/2026-07/control-plane/create_collection"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /collections/{collection_name}","title":"Describe a collection","href":"/reference/api/2026-07/control-plane/describe_collection"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml delete /collections/{collection_name}","title":"Delete a collection","href":"/reference/api/2026-07/control-plane/delete_collection"}]},{"group":"Backup schedules","pages":[{"title":"Create backup schedule","sidebarTitle":"Create backup schedule","api":"POST https://api.pinecone.io/indexes/{index_name}/backup-schedules","href":"/reference/api/2026-07/control-plane/create_backup_schedule"},{"title":"List backup schedules","sidebarTitle":"List backup schedules","api":"GET https://api.pinecone.io/indexes/{index_name}/backup-schedules","href":"/reference/api/2026-07/control-plane/list_backup_schedules"},{"title":"Describe backup schedule","sidebarTitle":"Describe backup schedule","api":"GET https://api.pinecone.io/backup-schedules/{schedule_id}","href":"/reference/api/2026-07/control-plane/describe_backup_schedule"},{"title":"Update backup schedule","sidebarTitle":"Update backup schedule","api":"PATCH https://api.pinecone.io/backup-schedules/{schedule_id}","href":"/reference/api/2026-07/control-plane/update_backup_schedule"},{"title":"Delete backup schedule","sidebarTitle":"Delete backup schedule","api":"DELETE https://api.pinecone.io/backup-schedules/{schedule_id}","href":"/reference/api/2026-07/control-plane/delete_backup_schedule"},{"title":"List backup schedule history","sidebarTitle":"List schedule history","api":"GET https://api.pinecone.io/backup-schedules/{schedule_id}/history","href":"/reference/api/2026-07/control-plane/list_backup_schedule_history"}]}]},{"group":"Inference","pages":[{"group":"Inference","pages":[{"title":"Generate vectors","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml post /embed","href":"/reference/api/2026-07/inference/generate-vectors"},{"title":"Rerank results","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml post /rerank","href":"/reference/api/2026-07/inference/rerank-results"},{"title":"List available models","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml get /models","href":"/reference/api/2026-07/inference/list-available-models"},{"title":"Describe a model","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml get /models/{model_name}","href":"/reference/api/2026-07/inference/describe-a-model"}]}]},{"group":"Admin","pages":[{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/projects","href":"/reference/api/2026-07/admin/projects/list-projects"},{"title":"Create a new project","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/projects","href":"/reference/api/2026-07/admin/projects/create-a-new-project"},{"title":"Get project details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/projects/{project_id}","href":"/reference/api/2026-07/admin/projects/get-project-details"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/projects/{project_id}","href":"/reference/api/2026-07/admin/projects/delete-a-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml patch /admin/projects/{project_id}","href":"/reference/api/2026-07/admin/projects/update-a-project"}]},{"group":"Organizations","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/organizations","href":"/reference/api/2026-07/admin/organizations/list-organizations"},{"title":"Get organization details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/organizations/{organization_id}","href":"/reference/api/2026-07/admin/organizations/get-organization-details"},{"title":"Delete an organization","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/organizations/{organization_id}","href":"/reference/api/2026-07/admin/organizations/delete-an-organization"},{"title":"Update an organization","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml patch /admin/organizations/{organization_id}","href":"/reference/api/2026-07/admin/organizations/update-an-organization"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/projects/{project_id}/api-keys","href":"/reference/api/2026-07/admin/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/projects/{project_id}/api-keys","href":"/reference/api/2026-07/admin/api-keys/create-an-api-key"},{"title":"Get API key details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/api-keys/{api_key_id}","href":"/reference/api/2026-07/admin/api-keys/get-api-key-details"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/api-keys/{api_key_id}","href":"/reference/api/2026-07/admin/api-keys/delete-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml patch /admin/api-keys/{api_key_id}","href":"/reference/api/2026-07/admin/api-keys/update-an-api-key"}]},{"group":"Users","pages":[{"title":"List users in the organization","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/users","href":"/reference/api/2026-07/admin/users/list-users-in-the-organization"},{"title":"Get user details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/users/{user_id}","href":"/reference/api/2026-07/admin/users/get-user-details"},{"title":"Remove a user from the organization","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/users/{user_id}","href":"/reference/api/2026-07/admin/users/remove-a-user-from-the-organization"}]},{"group":"Invites","pages":[{"title":"List invites","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/invites","href":"/reference/api/2026-07/admin/invites/list-invites"},{"title":"Invite a user to the organization","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/invites","href":"/reference/api/2026-07/admin/invites/invite-a-user-to-the-organization"},{"title":"Get invite details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/invites/{invite_id}","href":"/reference/api/2026-07/admin/invites/get-invite-details"},{"title":"Delete an invite","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/invites/{invite_id}","href":"/reference/api/2026-07/admin/invites/delete-an-invite"},{"title":"Resend an invite email","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/invites/{invite_id}/resend","href":"/reference/api/2026-07/admin/invites/resend-an-invite-email"}]},{"group":"Service Accounts","pages":[{"title":"List service accounts","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/service-accounts","href":"/reference/api/2026-07/admin/service-accounts/list-service-accounts"},{"title":"Create a service account","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/service-accounts","href":"/reference/api/2026-07/admin/service-accounts/create-a-service-account"},{"title":"Get service account details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/service-accounts/{service_account_id}","href":"/reference/api/2026-07/admin/service-accounts/get-service-account-details"},{"title":"Delete a service account","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/service-accounts/{service_account_id}","href":"/reference/api/2026-07/admin/service-accounts/delete-a-service-account"},{"title":"Update a service account","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml patch /admin/service-accounts/{service_account_id}","href":"/reference/api/2026-07/admin/service-accounts/update-a-service-account"},{"title":"Rotate a service account's OAuth client secret","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/service-accounts/{service_account_id}/rotate-secret","href":"/reference/api/2026-07/admin/service-accounts/rotate-a-service-accounts-oauth-client-secret"}]},{"group":"Role Bindings","pages":[{"title":"List role bindings","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/role-bindings","href":"/reference/api/2026-07/admin/role-bindings/list-role-bindings"},{"title":"Create a role binding","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/role-bindings","href":"/reference/api/2026-07/admin/role-bindings/create-a-role-binding"},{"title":"Get role binding details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/role-bindings/{role_binding_id}","href":"/reference/api/2026-07/admin/role-bindings/get-role-binding-details"},{"title":"Delete a role binding","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml delete /admin/role-bindings/{role_binding_id}","href":"/reference/api/2026-07/admin/role-bindings/delete-a-role-binding"}]},{"group":"Cost Usage Exports","pages":[{"title":"List cost usage exports","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/cost-usage-exports","href":"/reference/api/2026-07/admin/cost-usage-exports/list-cost-usage-exports"},{"title":"Create a cost usage export","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml post /admin/cost-usage-exports","href":"/reference/api/2026-07/admin/cost-usage-exports/create-a-cost-usage-export"},{"title":"Get cost usage export details","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/cost-usage-exports/{cost_usage_export_id}","href":"/reference/api/2026-07/admin/cost-usage-exports/get-cost-usage-export-details"}]}]},{"group":"SDKs","pages":[{"title":"Pinecone SDKs overview","href":"/reference/pinecone-sdks"},{"group":"Python","pages":[{"title":"Pinecone Python SDK","sidebarTitle":"Overview","href":"/reference/sdks/python/overview"},{"title":"Reference","url":"https://sdk.pinecone.io/python/","href":"/reference/sdks/python/reference"}]},{"group":"Node.js","pages":[{"title":"Pinecone Node.js SDK","sidebarTitle":"Overview","href":"/reference/sdks/node/overview"},{"title":"Reference","url":"https://sdk.pinecone.io/typescript/","href":"/reference/sdks/node/reference"}]},{"group":"Java","pages":[{"title":"Pinecone Java SDK","sidebarTitle":"Overview","href":"/reference/sdks/java/overview"},{"title":"Reference","url":"https://github.com/pinecone-io/pinecone-java-client","href":"/reference/sdks/java/reference"},{"title":"OpenTelemetry support","sidebarTitle":"OpenTelemetry","href":"/reference/sdks/java/open-telemetry"}]},{"group":"Go","pages":[{"title":"Pinecone Go SDK","sidebarTitle":"Overview","href":"/reference/sdks/go/overview"},{"title":"Reference","url":"https://github.com/pinecone-io/go-pinecone","href":"/reference/sdks/go/reference"}]}]},{"group":"CLI","pages":[{"title":"CLI quickstart","sidebarTitle":"Quickstart","href":"/reference/cli/quickstart"},{"title":"CLI command reference","sidebarTitle":"Command reference","href":"/reference/cli/command-reference"},{"title":"CLI authentication","sidebarTitle":"Authentication","href":"/reference/cli/authentication"},{"title":"CLI target context","sidebarTitle":"Target context","href":"/reference/cli/target-context"}]},{"group":"Tools","pages":[{"title":"Spark-Pinecone connector","href":"/reference/tools/pinecone-spark-connector"}]}]},{"version":"2026-04","pages":[{"title":"2026-04","href":"/reference/api/introduction"}]},{"version":"2025-10","pages":[{"title":"2025-10","href":"/reference/api/introduction"}]},{"version":"2025-04","pages":[{"title":"2025-04","href":"/reference/api/introduction"}]},{"version":"2025-01","pages":[{"title":"2025-01","href":"/reference/api/introduction"}]},{"version":"2024-10","pages":[{"title":"2024-10","href":"/reference/api/introduction"}]},{"version":"2024-07","pages":[{"title":"2024-07","href":"/reference/api/introduction"}]},{"version":"2024-04","pages":[{"title":"2024-04","href":"/reference/api/introduction"}]}]},{"tab":"Examples","groups":[{"group":"Examples","pages":[{"title":"Notebooks","href":"/examples/notebooks"},{"title":"Sample apps","href":"/examples/sample-apps"},{"title":"Reference architectures","href":"/examples/reference-architectures"}]}]},{"tab":"Models","groups":[{"group":"Models","pages":[{"title":"Pinecone model gallery","href":"/models/overview"}]}]},{"tab":"Integrations","groups":[{"group":"Connect an integration","pages":[{"title":"Integrations overview","sidebarTitle":"All integrations","href":"/integrations/overview"},{"group":"AI coding tools","pages":[{"title":"AI coding tools","sidebarTitle":"Overview","href":"/integrations/ai-coding-tools"},{"title":"Agent Skills","href":"/integrations/agent-skills"},{"title":"Claude Code plugin","href":"/integrations/claude-code"},{"title":"Codex plugin","href":"/integrations/codex"},{"title":"Cursor plugin","href":"/integrations/cursor"}]},{"group":"Data sources","pages":[{"title":"Airbyte","href":"/integrations/airbyte"},{"title":"Apify","href":"/integrations/apify"},{"title":"Aryn","href":"/integrations/aryn"},{"title":"Box","href":"/integrations/box"},{"title":"Confluent","href":"/integrations/confluent"},{"title":"Databricks","href":"/integrations/databricks"},{"title":"Estuary","href":"/integrations/estuary"},{"title":"Fleak","href":"/integrations/fleak"},{"title":"FlowiseAI","href":"/integrations/flowise"},{"title":"Gathr","href":"/integrations/gathr"},{"title":"Matillion","href":"/integrations/matillion"},{"title":"Nexla","href":"/integrations/nexla"},{"title":"Redpanda","href":"/integrations/redpanda"},{"title":"Snowflake Openflow","href":"/integrations/snowflake-openflow"},{"title":"StreamNative","href":"/integrations/streamnative"},{"title":"Unstructured","href":"/integrations/unstructured"}]},{"group":"Frameworks","pages":[{"title":"AI Engine","href":"/integrations/ai-engine"},{"title":"Amazon Bedrock","href":"/integrations/amazon-bedrock"},{"title":"Amazon SageMaker","href":"/integrations/amazon-sagemaker"},{"title":"Cloudera AI","href":"/integrations/cloudera"},{"title":"Context Data","href":"/integrations/context-data"},{"title":"Genkit","href":"/integrations/genkit"},{"title":"Haystack","href":"/integrations/haystack"},{"title":"Instill AI","href":"/integrations/instill"},{"title":"LangChain","href":"/integrations/langchain"},{"title":"LlamaIndex","href":"/integrations/llamaindex"},{"title":"n8n","href":"/integrations/n8n"},{"title":"Progress Agentic RAG","href":"/integrations/progress-agentic-rag"},{"title":"VoltAgent","href":"/integrations/voltagent"}]},{"group":"Infrastructure","pages":[{"title":"AWS Marketplace","href":"/integrations/aws-marketplace"},{"title":"Google Cloud Marketplace","href":"/integrations/google-cloud-marketplace"},{"title":"Microsoft Marketplace","href":"/integrations/microsoft-marketplace"},{"title":"Pulumi","href":"/integrations/pulumi"},{"title":"Terraform","href":"/integrations/terraform"},{"title":"Vercel","href":"/integrations/vercel"},{"title":"Zapier","href":"/integrations/zapier"}]},{"group":"Models","pages":[{"title":"Cohere","href":"/integrations/cohere"},{"title":"Voyage AI","href":"/integrations/voyage"},{"title":"Hugging Face Inference Endpoints","href":"/integrations/hugging-face-inference-endpoints"},{"title":"Jina AI","href":"/integrations/jina"},{"title":"OpenAI","href":"/integrations/openai"},{"title":"Twelve Labs","href":"/integrations/twelve-labs"}]},{"group":"Observability","pages":[{"title":"Datadog","href":"/integrations/datadog"},{"title":"HoneyHive","href":"/integrations/honeyhive"},{"title":"New Relic","href":"/integrations/new-relic"},{"title":"Traceloop","href":"/integrations/traceloop"},{"title":"TruLens","href":"/integrations/trulens"}]}]},{"group":"Build an integration","pages":[{"title":"Integration ecosystem","href":"/integrations/build-integration/integration-ecosystem"},{"title":"Attribute usage to your integration","href":"/integrations/build-integration/attribute-usage-to-your-integration"},{"title":"Connect your users to Pinecone","href":"/integrations/build-integration/connect-your-users-to-pinecone"}]}]},{"tab":"Admin","groups":[{"group":"Organizations","pages":[{"title":"Organizations overview","sidebarTitle":"Overview","href":"/admin/organizations/understanding-organizations"},{"title":"Manage organization members","sidebarTitle":"Manage members","href":"/admin/organizations/manage-organization-members"},{"title":"Manage organization service accounts","sidebarTitle":"Manage service accounts","href":"/admin/organizations/manage-service-accounts"},{"title":"Delete your organization","href":"/admin/organizations/delete-your-organization"}]},{"group":"Projects","pages":[{"title":"Projects overview","sidebarTitle":"Overview","href":"/admin/projects/understanding-projects"},{"title":"Create a project","mode":"wide","href":"/admin/projects/create-a-project"},{"title":"Manage projects","href":"/admin/projects/manage-projects"},{"title":"Manage project members","href":"/admin/projects/manage-project-members"},{"title":"Manage API keys","href":"/admin/projects/manage-api-keys"},{"title":"Manage project service accounts","sidebarTitle":"Manage service accounts","href":"/admin/projects/manage-service-accounts"}]},{"group":"Billing","pages":[{"title":"Upgrade your billing plan","href":"/admin/billing/upgrade-billing-plan"},{"title":"Redeem a promo code","href":"/admin/billing/redeem-a-promo-code"},{"title":"Change your payment method","href":"/admin/billing/change-payment-method"},{"title":"Account deactivation for non-payment","href":"/admin/billing/non-payment-account-deactivation"},{"title":"Downgrade your billing plan","href":"/admin/billing/downgrade-billing-plan"},{"title":"Download a usage report","href":"/admin/billing/download-usage-report"},{"title":"Access your invoices","href":"/admin/billing/access-your-invoices"},{"title":"Pinecone Standard plan trial","href":"/admin/billing/standard-trial"},{"title":"Billing disputes and refunds","href":"/admin/billing/billing-disputes-and-refunds"}]},{"group":"Security","pages":[{"title":"Security overview","sidebarTitle":"Overview","href":"/admin/security/security-overview"},{"title":"Manage roles and access","sidebarTitle":"Manage roles and access","href":"/admin/security/manage-rbac"},{"group":"Single sign-on","pages":[{"title":"Configure SSO with Okta","href":"/admin/security/configure-single-sign-on/okta"},{"title":"Manage roles with Okta","sidebarTitle":"Manage roles with Okta","href":"/admin/security/configure-single-sign-on/okta-role-management"},{"title":"SCIM provisioning with Okta","sidebarTitle":"SCIM provisioning with Okta","href":"/admin/security/configure-single-sign-on/okta-scim-provisioning"}]},{"title":"Configure audit logs","href":"/admin/security/configure-audit-logs"}]},{"group":"Account and support","pages":[{"title":"Get help with Pinecone","sidebarTitle":"Get help","href":"/admin/support/contact-support"},{"title":"Support plans and SLAs","href":"/admin/support/pinecone-support-slas"},{"title":"Login code issues","href":"/admin/account/login-code-issues"},{"title":"Custom data processing agreements","href":"/admin/account/custom-data-processing-agreements"},{"title":"Delete your account","href":"/admin/account/delete-your-account"}]}]}]},{"dropdown":"Pinecone Assistant","icon":"comments","tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Pinecone Assistant","sidebarTitle":"Overview","mode":"wide","href":"/guides/assistant/overview"},{"group":"Quickstart","pages":[{"title":"Pinecone Assistant: SDK quickstart","sidebarTitle":"SDK quickstart","href":"/guides/assistant/quickstart/sdk-quickstart"},{"title":"Pinecone Assistant: n8n quickstart","sidebarTitle":"n8n quickstart","href":"/guides/assistant/quickstart/n8n-quickstart"}]}]},{"group":"Build an assistant","pages":[{"title":"Create an assistant","mode":"wide","href":"/guides/assistant/create-assistant"},{"title":"Manage assistants","href":"/guides/assistant/manage-assistants"}]},{"group":"Upload your data","pages":[{"title":"Files in Pinecone Assistant","sidebarTitle":"Overview","href":"/guides/assistant/files-overview"},{"title":"Upload files","href":"/guides/assistant/upload-files"},{"title":"Multimodal context for assistants","sidebarTitle":"Multimodal context","href":"/guides/assistant/multimodal"},{"title":"Manage files","href":"/guides/assistant/manage-files"}]},{"group":"Chat with an assistant","pages":[{"title":"Chat through the standard interface","sidebarTitle":"Standard interface","href":"/guides/assistant/chat-with-assistant"},{"title":"Chat through the OpenAI-compatible interface","sidebarTitle":"OpenAI-compatible interface","href":"/guides/assistant/chat-through-the-openai-compatible-interface"}]},{"group":"Evaluate answers","pages":[{"title":"Evaluation overview","sidebarTitle":"Overview","href":"/guides/assistant/evaluation-overview"},{"title":"Evaluate answers","mode":"wide","href":"/guides/assistant/evaluate-answers"}]},{"group":"Retrieve context snippets","pages":[{"title":"Context snippets overview","sidebarTitle":"Overview","href":"/guides/assistant/context-snippets-overview"},{"title":"Retrieve context snippets","href":"/guides/assistant/retrieve-context-snippets"}]},{"group":"Integrate with AI agents","pages":[{"title":"Use an Assistant MCP server","sidebarTitle":"Use an MCP server","href":"/guides/assistant/mcp-server"}]},{"group":"Admin","pages":[{"title":"Pinecone Assistant pricing and limits","sidebarTitle":"Pricing and limits","href":"/guides/assistant/pricing-and-limits"},{"title":"Monitor usage and cost","href":"/guides/assistant/admin/monitor-spend-and-usage"},{"title":"Billing and access","url":"/admin/organizations/understanding-organizations","href":"/guides/assistant/admin-link"}]}]},{"tab":"Reference","versions":[{"version":"2026-07 (latest)","default":true,"groups":[{"group":"APIs","pages":[{"title":"Assistant API reference","sidebarTitle":"Introduction","href":"/reference/api/assistant/introduction"},{"title":"Pinecone Assistant API authentication","sidebarTitle":"Authentication","href":"/reference/api/assistant/authentication"},{"title":"Pinecone Assistant limits","sidebarTitle":"Limits","href":"/reference/api/assistant/assistant-limits"}]},{"group":"Assistants","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml GET /assistants","title":"List assistants","href":"/reference/api/2026-07/assistant/list_assistants"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml POST /assistants","title":"Create an assistant","href":"/reference/api/2026-07/assistant/create_assistant"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml GET /assistants/{assistant_name}","title":"Check assistant status","href":"/reference/api/2026-07/assistant/describe_assistant"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml PATCH /assistants/{assistant_name}","title":"Update an assistant","href":"/reference/api/2026-07/assistant/update_assistant"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_control_2026-07.oas.yaml DELETE /assistants/{assistant_name}","title":"Delete an assistant","href":"/reference/api/2026-07/assistant/delete_assistant"}]},{"group":"Files","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml GET /files/{assistant_name}","title":"List Files","href":"/reference/api/2026-07/assistant/list_files"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml POST /files/{assistant_name}","title":"Upload a file","href":"/reference/api/2026-07/assistant/upload_file"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml PUT /files/{assistant_name}/{assistant_file_id}","title":"Upsert a file","href":"/reference/api/2026-07/assistant/upsert_file"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml GET /files/{assistant_name}/{assistant_file_id}","title":"Describe a file","href":"/reference/api/2026-07/assistant/describe_file"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml DELETE /files/{assistant_name}/{assistant_file_id}","title":"Delete a file","href":"/reference/api/2026-07/assistant/delete_file"}]},{"group":"Operations","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml GET /operations/{assistant_name}","title":"List operations","href":"/reference/api/2026-07/assistant/list_operations"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml GET /operations/{assistant_name}/{operation_id}","title":"Describe an operation","href":"/reference/api/2026-07/assistant/describe_operation"}]},{"group":"Chat","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml POST /chat/{assistant_name}","title":"Chat with an assistant","href":"/reference/api/2026-07/assistant/chat_assistant"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml POST /chat/{assistant_name}/chat/completions","title":"Chat through an OpenAI-compatible interface","href":"/reference/api/2026-07/assistant/chat_completion_assistant"}]},{"group":"Evaluation","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_evaluation_2026-07.oas.yaml POST /evaluation/metrics/alignment","title":"Evaluate an answer","href":"/reference/api/2026-07/assistant/metrics_alignment"}]},{"group":"Context snippets","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/assistant_data_2026-07.oas.yaml POST /chat/{assistant_name}/context","title":"Retrieve context from an assistant","href":"/reference/api/2026-07/assistant/context_assistant"}]},{"group":"Admin","pages":[{"group":"API keys","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml post /admin/projects/{project_id}/api-keys","title":"Create an API key","href":"/reference/api/2026-04/admin-assistant/create_api_key"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml get /admin/projects/{project_id}/api-keys","title":"List API keys","href":"/reference/api/2026-04/admin-assistant/list_api_keys"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml get /admin/api-keys/{api_key_id}","title":"Get API key details","href":"/reference/api/2026-04/admin-assistant/fetch_api_key"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml patch /admin/api-keys/{api_key_id}","title":"Update an API key","href":"/reference/api/2026-04/admin-assistant/update_api_key"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml delete /admin/api-keys/{api_key_id}","title":"Delete an API key","href":"/reference/api/2026-04/admin-assistant/delete_api_key"}]},{"group":"Projects","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml post /admin/projects","title":"Create a new project","href":"/reference/api/2026-04/admin-assistant/create_project"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml get /admin/projects","title":"List projects","href":"/reference/api/2026-04/admin-assistant/list_projects"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml get /admin/projects/{project_id}","title":"Get project details","href":"/reference/api/2026-04/admin-assistant/fetch_project"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml patch /admin/projects/{project_id}","title":"Update a project","href":"/reference/api/2026-04/admin-assistant/update_project"},{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml delete /admin/projects/{project_id}","title":"Delete a project","href":"/reference/api/2026-04/admin-assistant/delete_project"}]},{"group":"Service accounts","pages":[{"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/oauth_2026-04.oas.yaml post /oauth/token","title":"Create an access token","href":"/reference/api/2026-04/admin-assistant/get_token"}]}]},{"group":"Architecture","pages":[{"title":"Pinecone Assistant architecture","sidebarTitle":"Assistant architecture","href":"/reference/architecture/assistant-architecture"}]}]},{"version":"2026-04","pages":[{"title":"2026-04","href":"/reference/api/assistant/introduction"}]},{"version":"2025-10","pages":[{"title":"2025-10","href":"/reference/api/assistant/introduction"}]},{"version":"2025-04","pages":[{"title":"2025-04","href":"/reference/api/assistant/introduction"}]},{"version":"2025-01","pages":[{"title":"2025-01","href":"/reference/api/assistant/introduction"}]}]},{"tab":"Examples","pages":[{"title":"Assistant examples","href":"/examples/assistant"}]}]},{"dropdown":"Pinecone Nexus","icon":"brain-circuit","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/nexus/overview"}]},{"tab":"Reference","groups":[{"group":"APIs","pages":[{"title":"Pinecone Nexus API","sidebarTitle":"Introduction","href":"/reference/api/nexus/introduction"},{"title":"Pinecone Nexus API authentication","sidebarTitle":"Authentication","href":"/reference/api/nexus/authentication"}]},{"group":"Control plane","pages":[{"group":"Manage Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_control_2026-07.oas.yaml get /workspaces","href":"/api-reference/manage-workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_control_2026-07.oas.yaml post /workspaces","href":"/api-reference/manage-workspaces/create-a-workspace"},{"title":"Describe a workspace","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_control_2026-07.oas.yaml get /workspaces/{workspace_name}","href":"/api-reference/manage-workspaces/describe-a-workspace"},{"title":"Delete a workspace","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_control_2026-07.oas.yaml delete /workspaces/{workspace_name}","href":"/api-reference/manage-workspaces/delete-a-workspace"}]}]},{"group":"Data plane","pages":[{"group":"Auth","pages":[{"title":"Exchange a Pinecone API key for a session token","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /auth/login","href":"/api-reference/auth/exchange-a-pinecone-api-key-for-a-session-token"},{"title":"Current identity (whoami)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /auth","href":"/api-reference/auth/current-identity-whoami"}]},{"group":"Project","pages":[{"title":"Get the active project","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /project","href":"/api-reference/project/get-the-active-project"},{"title":"Project-wide task stats","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /stats","href":"/api-reference/project/project-wide-task-stats"}]},{"group":"Connectors","pages":[{"title":"List the project's linked connectors","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /connectors","href":"/api-reference/connectors/list-the-projects-linked-connectors"},{"title":"Get a connector","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /connectors/{id}","href":"/api-reference/connectors/get-a-connector"},{"title":"Unlink a connector","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /connectors/{id}","href":"/api-reference/connectors/unlink-a-connector"},{"title":"Start the OAuth link flow for a provider","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /connectors/oauth/{provider}/start","href":"/api-reference/connectors/start-the-oauth-link-flow-for-a-provider"},{"title":"Link a connector with an API key","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /connectors/keys/{provider}","href":"/api-reference/connectors/link-a-connector-with-an-api-key"},{"title":"Browse a connector's folders/files","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /connectors/{id}/items","href":"/api-reference/connectors/browse-a-connectors-foldersfiles"},{"title":"List a context's connectors (with per-context enabled flag)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/connectors","href":"/api-reference/connectors/list-a-contexts-connectors-with-per-context-enabled-flag"},{"title":"Enable or disable a connector for a context","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml put /contexts/{slug}/connectors/{connector_id}","href":"/api-reference/connectors/enable-or-disable-a-connector-for-a-context"}]},{"group":"Contexts","pages":[{"title":"List contexts (newest first, with stats)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts","href":"/api-reference/contexts/list-contexts-newest-first-with-stats"},{"title":"Create a context","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts","href":"/api-reference/contexts/create-a-context"},{"title":"Get a context","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}","href":"/api-reference/contexts/get-a-context"},{"title":"Update a context","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml put /contexts/{slug}","href":"/api-reference/contexts/update-a-context"},{"title":"Delete a context (and its Pinecone indexes)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /contexts/{slug}","href":"/api-reference/contexts/delete-a-context-and-its-pinecone-indexes"},{"title":"Per-context task statistics","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/tasks/stats","href":"/api-reference/contexts/per-context-task-statistics"},{"title":"Trigger an on-demand self-tuning optimize","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/optimize","href":"/api-reference/contexts/trigger-an-on-demand-self-tuning-optimize"},{"title":"Run the Design-flow explore agent (propose a manifest)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/explore","href":"/api-reference/contexts/run-the-design-flow-explore-agent-propose-a-manifest"},{"title":"Estimate the token + time cost of curating the in-progress manifest","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/profile","href":"/api-reference/contexts/estimate-the-token-+-time-cost-of-curating-the-in-progress-manifest"}]},{"group":"Manifest","pages":[{"title":"Get the context's manifest","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/manifest","href":"/api-reference/manifest/get-the-contexts-manifest"},{"title":"List the built-in manifest templates","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /manifest/templates","href":"/api-reference/manifest/list-the-built-in-manifest-templates"}]},{"group":"Curation","pages":[{"title":"Get the curation ledger","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/curate","href":"/api-reference/curation/get-the-curation-ledger"},{"title":"Build or rebuild the context's index from its sources","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/curate","href":"/api-reference/curation/build-or-rebuild-the-contexts-index-from-its-sources"},{"title":"Drop named sources from the index + ledger","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/curate/delete-sources","href":"/api-reference/curation/drop-named-sources-from-the-index-+-ledger"}]},{"group":"Source Files","pages":[{"title":"Import source documents from a project connector","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/import","href":"/api-reference/source-files/import-source-documents-from-a-project-connector"},{"title":"Upload a source file or archive","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /contexts/{slug}/import/upload","href":"/api-reference/source-files/upload-a-source-file-or-archive"},{"title":"List the source file tree (root)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/source/list","href":"/api-reference/source-files/list-the-source-file-tree-root"},{"title":"Source file/dir/size counts","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/source/stats","href":"/api-reference/source-files/source-filedirsize-counts"},{"title":"Flat manifest of source files (path, size, last_modified)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/source/manifest","href":"/api-reference/source-files/flat-manifest-of-source-files-path-size-last_modified"},{"title":"List the source file tree under a path","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/source/list/{path}","href":"/api-reference/source-files/list-the-source-file-tree-under-a-path"},{"title":"Read a source file (raw bytes)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/source/read/{path}","href":"/api-reference/source-files/read-a-source-file-raw-bytes"},{"title":"Delete a source file","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /contexts/{slug}/source/delete/{path}","href":"/api-reference/source-files/delete-a-source-file"}]},{"group":"Knowledge","pages":[{"title":"List curated knowledge (root)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/knowledge/list","href":"/api-reference/knowledge/list-curated-knowledge-root"},{"title":"Knowledge file/dir/size counts","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/knowledge/stats","href":"/api-reference/knowledge/knowledge-filedirsize-counts"},{"title":"List curated knowledge under a path","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/knowledge/list/{path}","href":"/api-reference/knowledge/list-curated-knowledge-under-a-path"},{"title":"Read a curated knowledge file (raw bytes)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /contexts/{slug}/knowledge/read/{path}","href":"/api-reference/knowledge/read-a-curated-knowledge-file-raw-bytes"}]},{"group":"Query","pages":[{"title":"Run one KnowQL query turn","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /query","href":"/api-reference/query/run-one-knowql-query-turn"},{"title":"Fetch one query (turn)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /queries/{id}","href":"/api-reference/query/fetch-one-query-turn"},{"title":"Cancel an in-progress query turn","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /queries/{id}/cancel","href":"/api-reference/query/cancel-an-in-progress-query-turn"},{"title":"Fetch the recorded trace for a query turn","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /queries/{id}/trace","href":"/api-reference/query/fetch-the-recorded-trace-for-a-query-turn"},{"title":"Stream a query turn's events (SSE)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /queries/{id}/events","href":"/api-reference/query/stream-a-query-turns-events-sse"},{"title":"Record thumbs-up/down feedback on a query turn","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml post /queries/{id}/feedback","href":"/api-reference/query/record-thumbs-updown-feedback-on-a-query-turn"},{"title":"List the selectable query models","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /models","href":"/api-reference/query/list-the-selectable-query-models"},{"title":"List project-wide query sessions (newest first)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /sessions","href":"/api-reference/query/list-project-wide-query-sessions-newest-first"},{"title":"Get a session with its queries (conversation order)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /sessions/{id}","href":"/api-reference/query/get-a-session-with-its-queries-conversation-order"},{"title":"Delete a session and its queries","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /sessions/{id}","href":"/api-reference/query/delete-a-session-and-its-queries"}]},{"group":"Tasks","pages":[{"title":"List tasks (project-wide, paginated)","description":"Task records across the project, newest first. Filter by workflow, state, or context, and page with `limit` plus `page` or `offset`.","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks","href":"/api-reference/tasks/list-tasks-project-wide-paginated"},{"title":"Get a task (with steps)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}","href":"/api-reference/tasks/get-a-task-with-steps"},{"title":"Cancel/terminate a task","description":"Body is optional. Max body 1 MiB.","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /tasks/{id}","href":"/api-reference/tasks/cancelterminate-a-task"}]},{"group":"Task Files","pages":[{"title":"Read a task file (raw bytes)","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}/files/read/{path}","href":"/api-reference/task-files/read-a-task-file-raw-bytes"},{"title":"Stat a task file","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}/files/metadata/{path}","href":"/api-reference/task-files/stat-a-task-file"},{"title":"List a task's files under a path","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}/files/list/{path}","href":"/api-reference/task-files/list-a-tasks-files-under-a-path"},{"title":"List a task's working-directory files","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml get /tasks/{id}/files/list","href":"/api-reference/task-files/list-a-tasks-working-directory-files"},{"title":"Delete a task file","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/nexus_data_2026-07.oas.yaml delete /tasks/{id}/files/delete/{path}","href":"/api-reference/task-files/delete-a-task-file"}]}]}]}]},{"dropdown":"pg_pinecone","icon":"elephant","tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"pg_pinecone","sidebarTitle":"Overview","href":"/guides/pg-pinecone/overview"},{"title":"pg_pinecone quickstart","sidebarTitle":"Quickstart","href":"/guides/pg-pinecone/quickstart"}]},{"group":"Build","pages":[{"title":"pg_pinecone storage engines","sidebarTitle":"Storage engines","href":"/guides/pg-pinecone/storage-engines"},{"title":"Switch from pgvector to native","href":"/guides/pg-pinecone/switch-from-pgvector"},{"title":"Switch from native to remote","href":"/guides/pg-pinecone/switch-to-remote"},{"title":"Search a table with full-text search","href":"/guides/pg-pinecone/full-text-search"},{"title":"Migrate from pgvector","url":"https://docs.pinecone.io/guides/index-data/migrate-from-pgvector","href":"/guides/pg-pinecone/migrate-from-pgvector"}]},{"group":"Resources","pages":[{"title":"pg_pinecone SQL reference","sidebarTitle":"SQL reference","url":"https://github.com/pinecone-io/pg_pinecone/blob/main/docs/reference.md","href":"/reference/pg-pinecone/sql-reference"},{"title":"pg_pinecone operator runbook","sidebarTitle":"Operator runbook","url":"https://github.com/pinecone-io/pg_pinecone/blob/main/docs/runbook.md","href":"/reference/pg-pinecone/operator-runbook"},{"title":"pg_pinecone support","sidebarTitle":"Support","href":"/guides/pg-pinecone/support"}]}]}]},{"dropdown":"Changelog","icon":"list","pages":[{"title":"Pinecone 2026 changelog","sidebarTitle":"2026","mode":"wide","href":"/release-notes/2026"},{"title":"Pinecone 2025 changelog","sidebarTitle":"2025","mode":"wide","href":"/release-notes/2025"},{"title":"Pinecone 2024 changelog","sidebarTitle":"2024","mode":"wide","href":"/release-notes/2024"},{"title":"Pinecone 2023 changelog","sidebarTitle":"2023","mode":"wide","href":"/release-notes/2023"},{"title":"Pinecone 2022 changelog","sidebarTitle":"2022","mode":"wide","href":"/release-notes/2022"},{"title":"Pinecone feature availability","sidebarTitle":"Feature availability","mode":"wide","href":"/release-notes/feature-availability"}]}]},"basePath":"","title":"Get a task (with steps) - Pinecone Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}