This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens.
Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing.
Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Occtoo Documentation","colors":{"primary":"#E36103","light":"#FA9A17","dark":"#EB8F38"},"logo":{"light":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87","dark":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-dark.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=d127d743e86586f660c4432069ac6e7f"},"favicon":"https://mintcdn.com/occtoo/wBeHKCIOR2NPRpYE/favicon.ico?fit=max\u0026auto=format\u0026n=wBeHKCIOR2NPRpYE\u0026q=85\u0026s=2ef86d93e26a6f82f9947f1881a0e8e8","navbar":{"links":[{"href":"https://www.occtoo.com","label":"occtoo.com"}]},"footer":{"socials":{"github":"https://github.com/Occtoo","linkedin":"https://www.linkedin.com/company/occtoo"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"occtoo","hasAudioNarration":false,"actualSubdomain":"occtoo","customDomains":["docs.occtoo.com"],"gitSource":{"type":"github","owner":"occtoo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","collectionId":"9fb5ceeb-bec7-4a13-8fd7-bd3f632e547b","liveDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb5f3cb256aa4200f8bb43","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":131},{"language":"default","tag":"Guides","count":112},{"language":"default","tag":"Occtoo Studio","count":99},{"language":"default","tag":"API Reference","count":44},{"language":"default","tag":"Sources","count":33},{"language":"default","tag":"Configuration API","count":26},{"language":"default","tag":"Destinations","count":18},{"language":"default","tag":"Partner Zone","count":13},{"language":"default","tag":"Cards","count":13},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child>code:only-child{white-space:nowrap}.occ-hero h1,.occ-home{margin:0 auto;color:var(--occ-ink)}.occ-home{--occ-accent:rgb(var(--primary));--occ-accent-text:color-mix(in srgb, rgb(var(--primary)) 82%, #1d1916);--occ-ink:#1d1916;--occ-strong:#2c2825;--occ-muted:#565250;--occ-border:rgb(3 7 18 / 0.1);--occ-card:#ffffff;--occ-tile:rgb(var(--primary) / 0.09);--occ-panel:rgb(var(--primary) / 0.06);--occ-hover-border:rgb(var(--primary) / 0.45);--occ-on-accent:#ffffff;--occ-shadow:rgba(29, 25, 22, 0.22);max-width:72rem;padding:0 1.5rem 5rem;font-size:15px;line-height:1.55}.dark .occ-home{--occ-accent:rgb(var(--primary-light));--occ-accent-text:rgb(var(--primary-light));--occ-ink:#e5e1de;--occ-strong:#ffffff;--occ-muted:#a39d97;--occ-border:rgb(255 255 255 / 0.1);--occ-card:rgb(var(--background-dark));--occ-tile:rgb(var(--primary-light) / 0.14);--occ-panel:rgb(var(--primary-light) / 0.07);--occ-hover-border:rgb(var(--primary-light) / 0.45);--occ-on-accent:rgb(var(--background-dark));--occ-shadow:rgba(0, 0, 0, 0.55)}.occ-home a{text-decoration:none}.occ-arrow{flex:none;width:15px;height:15px}.occ-hero{text-align:center;padding:3.75rem 0 2.5rem}.occ-eyebrow{font-size:11px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--occ-accent-text);margin:0 0 1.25rem}.occ-hero h1{max-width:18ch;font-size:clamp(2.25rem,5.2vw,3.4rem);font-weight:800;letter-spacing:-.03em;line-height:1.07}.occ-dot,.occ-pill svg{color:var(--occ-accent)}.occ-hl{color:var(--occ-accent-text)}.occ-lede{max-width:44ch;margin:1.15rem auto 0;color:var(--occ-muted)}.occ-popular{display:flex;flex-wrap:wrap;align-items:center;justify-content:center;gap:.5rem;margin-top:1.65rem}.occ-pill,.occ-popular-label{font-size:12px;font-weight:600}.occ-popular-label{margin-right:.25rem;color:var(--occ-muted)}.occ-pill{display:inline-flex;align-items:center;gap:.4rem;padding:.35rem .8rem;border:1px solid var(--occ-border);border-radius:999px;background:var(--occ-card);color:var(--occ-ink);transition:border-color .15s ease,transform .15s ease}.occ-pill:hover{border-color:var(--occ-accent);transform:translateY(-1px)}.occ-pill svg{flex:none}.occ-section-head{display:flex;align-items:baseline;justify-content:space-between;gap:1rem;margin:1.1rem 0}.occ-card h3,.occ-panel-head h2,.occ-section-head h2{font-weight:700;letter-spacing:-.02em;color:var(--occ-ink)}.occ-section-head h2{margin:0;font-size:1.35rem}.occ-section-link{display:inline-flex;align-items:center;gap:.35rem;font-size:13px;font-weight:600;white-space:nowrap;color:var(--occ-accent);transition:opacity .15s ease}.occ-section-link:hover{opacity:.75}.occ-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:1rem}.occ-card{display:flex;flex-direction:column;padding:1.5rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease,box-shadow .15s ease}.occ-card:hover{border-color:var(--occ-hover-border);box-shadow:0 8px 22px -14px var(--occ-shadow)}.occ-tile{--occ-tile-size:34px;display:inline-flex;align-items:center;justify-content:center;flex:none;width:var(--occ-tile-size);height:var(--occ-tile-size);border-radius:10px;background:var(--occ-tile);color:var(--occ-accent)}.occ-card .occ-tile{--occ-tile-size:44px;border-radius:12px;margin-bottom:1.25rem}.occ-card .occ-tile svg{width:22px;height:22px}.occ-card h3{margin:0 0 .5rem;font-size:17px;letter-spacing:-.01em;color:var(--occ-strong)}.occ-card p{margin:0 0 1.35rem;font-size:13.5px;line-height:1.55;color:var(--occ-muted)}.occ-card-links{margin-top:auto}.occ-sub{display:flex;align-items:center;justify-content:space-between;gap:.5rem;padding:.6rem 0;border-top:1px solid var(--occ-border);font-size:13px;font-weight:500;color:var(--occ-accent-text);transition:color .15s ease}.occ-sub .occ-arrow{opacity:.55}.occ-sub:hover{color:var(--occ-accent)}.occ-sub:hover .occ-arrow{opacity:1}.occ-panel{margin-top:1.75rem;padding:1.5rem;border:1px solid var(--occ-border);border-radius:16px;background:var(--occ-panel)}.occ-panel-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;margin-bottom:1.25rem}.occ-panel-head h2{margin:.35rem 0 0;font-size:1.3rem}.occ-button{display:inline-flex;align-items:center;gap:.4rem;padding:.5rem 1rem;border-radius:8px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:12.5px;font-weight:700;white-space:nowrap;transition:filter .15s ease,transform .15s ease}.occ-button:hover{filter:brightness(1.07);transform:translateY(-1px)}.occ-steps{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:.85rem}.occ-step{padding:.9rem;border:1px solid var(--occ-border);border-radius:12px;background:var(--occ-card)}.occ-step-num{display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;margin-bottom:.85rem;border-radius:999px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:11px;font-weight:700}.occ-footer-card h3,.occ-step h4{margin:0 0 .25rem;font-size:12.5px;font-weight:700;color:var(--occ-strong)}.occ-footer-card p,.occ-step p{margin:0;font-size:11.5px;line-height:1.45;color:var(--occ-muted)}.occ-footer-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1rem;margin-top:1.75rem}.occ-footer-card{display:flex;align-items:flex-start;gap:.75rem;padding:1rem 1.1rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease}.occ-footer-card:hover{border-color:var(--occ-hover-border)}.occ-footer-card h3{margin:0 0 .15rem;font-size:13.5px}.occ-footer-card p{font-size:12px}.occ-footer-arrow{margin-left:auto;color:var(--occ-muted)}@media (max-width:900px){.occ-grid,.occ-steps{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (max-width:620px){.occ-footer-grid,.occ-grid,.occ-steps{grid-template-columns:minmax(0,1fr)}.occ-hero{padding-top:2.5rem}}"}],"page":{"pagePath":"api-reference/ingest/start-an-asynchronous-ingest","slug":"/api-reference/ingest/start-an-asynchronous-ingest","pageMetadata":{"title":"Start an asynchronous ingest","description":"\u003cWarning>This endpoint is deprecated and will be removed on 1 May 2027. Use [typed source ingest](/api-reference/ingest/typed-source-entries) (`POST /v1/sources/{sourceId}`) instead. It validates values against source property types and uses tenant-level Application tokens.\u003c/Warning>\n\nValidates and accepts source entries for asynchronous processing. A `202` response means the request was queued; it does not mean every entry has finished processing.\n\nPersist `result.id` as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful `202` response merely because downstream data is not visible yet.","deprecated":true,"version":null,"openapi":"/api-reference/openapi/ingest.json post /datasources/{dataSource}/import","href":"/api-reference/ingest/start-an-asynchronous-ingest","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n }, {Warning} = _components;\n if (!Warning) _missingMdxReference(\"Warning\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(Warning, {\n children: [\"This endpoint is deprecated and will be removed on 1 May 2027. Use \", _jsx(_components.a, {\n href: \"/api-reference/ingest/typed-source-entries\",\n children: \"typed source ingest\"\n }), \" (\", _jsx(_components.code, {\n children: \"POST /v1/sources/{sourceId}\"\n }), \") instead. It validates values against source property types and uses tenant-level Application tokens.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Validates and accepts source entries for asynchronous processing. A \", _jsx(_components.code, {\n children: \"202\"\n }), \" response means the request was queued; it does not mean every entry has finished processing.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Persist \", _jsx(_components.code, {\n children: \"result.id\"\n }), \" as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful \", _jsx(_components.code, {\n children: \"202\"\n }), \" response merely because downstream data is not visible yet.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\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":"Start an asynchronous ingest","description":"\u003cWarning>This endpoint is deprecated and will be removed on 1 May 2027. Use [typed source ingest](/api-reference/ingest/typed-source-entries) (`POST /v1/sources/{sourceId}`) instead. It validates values against source property types and uses tenant-level Application tokens.\u003c/Warning>\n\nValidates and accepts source entries for asynchronous processing. A `202` response means the request was queued; it does not mean every entry has finished processing.\n\nPersist `result.id` as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful `202` response merely because downstream data is not visible yet.","deprecated":true,"version":null,"openapi":"/api-reference/openapi/ingest.json post /datasources/{dataSource}/import","href":"/api-reference/ingest/start-an-asynchronous-ingest","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Ingest"],"summary":"Start an asynchronous ingest","description":"\u003cWarning>This endpoint is deprecated and will be removed on 1 May 2027. Use [typed source ingest](/api-reference/ingest/typed-source-entries) (`POST /v1/sources/{sourceId}`) instead. It validates values against source property types and uses tenant-level Application tokens.\u003c/Warning>\n\nValidates and accepts source entries for asynchronous processing. A `202` response means the request was queued; it does not mean every entry has finished processing.\n\nPersist `result.id` as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful `202` response merely because downstream data is not visible yet.","operationId":"startIngest","deprecated":true,"parameters":["3afd7caa-0f52-4147-a1ed-766027267617"],"requestBody":"4514feae-4059-4ec8-8637-7fd4d0d9a85a","responses":{"202":"df9875d5-52d8-4cc9-8ddd-c0d3b9b7553d","400":"761296ee-acdc-43d7-931e-31609d0b0dc2","401":"ea1b5b68-f051-4848-a970-e32da295069d","403":"4f3fff2e-b8a7-4cca-8974-b1d0e2f7b75e","404":"6c7f5db2-326e-4b08-b9c9-f999abf8e65c","409":"fe640916-5299-4abc-b761-51b66d0a992a","429":"d0cf2e01-9d3c-4e75-ae7e-7e473eedee4b","500":"6d8f8739-08c3-4e6b-a6ae-7b5a5b9dced2"},"security":["73a0d934-cf6c-46d4-afd6-c3245b4f7177","ad2671a7-10a8-41ab-9249-ac1e337310f6","97efe092-ca5c-4db2-a8b9-df5ac7ebe130"],"x-required-permissions":["import-datasource","write:sources"],"x-permission-match":"any","method":"post","type":"path","servers":["786a0413-aa9a-44da-9f75-9b6901ab3075"],"path":"/datasources/{dataSource}/import","baseUrlOptions":["https://api.occtoo.com"],"title":"Start an asynchronous ingest","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3afd7caa-0f52-4147-a1ed-766027267617":{"name":"dataSource","in":"path","description":"Stable customer-facing source id within the authenticated tenant.","required":true,"schema":{"minLength":1,"type":"string","example":"products","isRequired":true,"description":"Stable customer-facing source id within the authenticated tenant.","uniqueKey":"","typeLabel":"string"},"example":"products"}},"requestBody":{"content":{"application/json":{"schema":{"required":["entities"],"type":"object","properties":{"entities":{"minItems":1,"type":"array","items":{"required":["key","delete","properties"],"type":"object","properties":{"key":{"maxLength":256,"minLength":1,"type":"string","description":"Entry key unique within this request.","example":"sku-123","isRequired":true,"uniqueKey":"entities.items.[INDEX].key","typeLabel":"string"},"delete":{"type":"boolean","description":"When true, delete the entry and send an empty properties array.","example":false,"isRequired":true,"uniqueKey":"entities.items.[INDEX].delete","typeLabel":"boolean"},"properties":{"type":"array","items":{"required":["id","value"],"type":"object","properties":{"id":{"maxLength":256,"minLength":1,"type":"string","description":"Property id. Repeated ids are permitted only for distinct languages; reserved system ids are rejected.","example":"name","isRequired":true,"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].id","typeLabel":"string"},"value":{"type":"string","description":"Property value encoded as text.","example":"Blue chair","isRequired":true,"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].value","typeLabel":"string"},"language":{"oneOf":[{"maxLength":10,"minLength":2,"type":"null","description":"Optional language code for localized values.","example":"en","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].language.oneOf.0","typeLabel":"null"},{"maxLength":10,"minLength":2,"type":"string","description":"Optional language code for localized values.","example":"en","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].language.oneOf.1","typeLabel":"string"}],"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].language","typeLabel":"null | string"},"delimiter":{"oneOf":[{"type":"null","description":"Optional delimiter used to split list values.","example":"|","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].delimiter.oneOf.0","typeLabel":"null"},{"type":"string","description":"Optional delimiter used to split list values.","example":"|","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].delimiter.oneOf.1","typeLabel":"string"}],"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].delimiter","typeLabel":"null | string"},"type":{"oneOf":[{"enum":["Text","LocalizedText","List","LocalizedList","Boolean","Timestamp","Integer","Decimal"],"type":"null","description":"Optional value type hint.","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].type.oneOf.0","typeLabel":"null"},{"enum":["Text","LocalizedText","List","LocalizedList","Boolean","Timestamp","Integer","Decimal"],"type":"string","description":"Optional value type hint.","uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].type.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX].type","typeLabel":"null | enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"entities.items.[INDEX].properties.items.[INDEX]","typeLabel":"object"},"description":"Entry property values. Property ids are canonicalized to lowercase at rest.","isRequired":true,"uniqueKey":"entities.items.[INDEX].properties","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"entities.items.[INDEX]","typeLabel":"object"},"description":"Non-empty collection of source entries. Keys must be unique within the request, compared case-insensitively.","isRequired":true,"uniqueKey":"entities","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"example","value":{"entities":[{"key":"sku-123","delete":false,"properties":[{"id":"name","value":"Blue chair","language":"en"},{"id":"inStock","value":"true","type":"Boolean"},{"id":"tags","value":"summer|sale","delimiter":"|","type":"List"}]},{"key":"sku-obsolete","delete":true,"properties":[]}]}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"df9875d5-52d8-4cc9-8ddd-c0d3b9b7553d":{"description":"The import was accepted and queued for asynchronous processing.","content":{"application/json":{"schema":{"required":["errors","requestId","result"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"result":{"required":["id"],"type":"object","properties":{"id":{"type":"string","description":"Ingest correlation id. This is not an HTTP request id and currently has no public status endpoint.","format":"uuid","example":"83b538a7-df7c-4cf4-b988-cd3b71c4cd90","isRequired":true,"uniqueKey":"result.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"result","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"example","value":{"result":{"id":"83b538a7-df7c-4cf4-b988-cd3b71c4cd90"},"errors":[],"requestId":"01JZP4FQ2Y7JYV5Y2R8B4X9Q3W"}}},"exampleType":"examples"}},"exampleType":"examples"},"761296ee-acdc-43d7-931e-31609d0b0dc2":{"description":"Malformed payload, invalid or duplicate keys/properties/languages, reserved properties, or a configured size ceiling was exceeded.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ea1b5b68-f051-4848-a970-e32da295069d":{"description":"Authentication is missing or invalid.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4f3fff2e-b8a7-4cca-8974-b1d0e2f7b75e":{"description":"The caller has neither `import-datasource` nor `write:sources`, the tenant application is not granted this source, or a legacy data-provider application is inactive or not assigned to this source.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6c7f5db2-326e-4b08-b9c9-f999abf8e65c":{"description":"The requested data source cannot be resolved.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fe640916-5299-4abc-b761-51b66d0a992a":{"description":"The data source is being purged or is in another conflicting state.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d0cf2e01-9d3c-4e75-ae7e-7e473eedee4b":{"description":"The tenant request-rate budget is exhausted. Retry after the indicated delay using bounded exponential backoff.","headers":{"Retry-After":{"description":"Optional number of seconds to wait before retrying.","schema":{"minimum":1,"type":"integer"}}},"content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6d8f8739-08c3-4e6b-a6ae-7b5a5b9dced2":{"description":"The ingest operation failed unexpectedly. Retry transient failures with bounded exponential backoff.","content":{"application/json":{"schema":{"required":["errors","requestId"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"details":{"oneOf":[{"type":"null","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.0","typeLabel":"null"},{"type":"object","description":"Optional structured validation details.","uniqueKey":"errors.items.[INDEX].details.oneOf.1","typeLabel":"object"}],"uniqueKey":"errors.items.[INDEX].details","typeLabel":"null | object"}},"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"requestId":{"type":"string","description":"HTTP request id used for support and diagnostics.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"message":"\u003cstring>","details":{}}],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"73a0d934-cf6c-46d4-afd6-c3245b4f7177":{"kindeOAuth":{"type":"oauth2","description":"Sign in with the existing Occtoo Studio identity and selected organization.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.occtoo.com/oauth2/auth?audience=https%3A%2F%2Fapi-weu.occtoo.com","tokenUrl":"https://auth.occtoo.com/oauth2/token","scopes":{"openid":"Authenticate the user with OpenID Connect.","profile":"Read the user's basic profile.","email":"Read the user's email address.","offline":"Refresh the access token without another interactive sign-in."},"x-usePkce":"SHA-256","x-scalar-redirect-uri":"https://api.occtoo.com/docs/"}},"scopes":[],"schemeName":"kindeOAuth"}},"ad2671a7-10a8-41ab-9249-ac1e337310f6":{"bearerAuth":{"type":"http","description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}},"97efe092-ca5c-4db2-a8b9-df5ac7ebe130":{"apiKey":{"type":"apiKey","description":"Occtoo organization API key.","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"}}},"servers":{"786a0413-aa9a-44da-9f75-9b6901ab3075":{"url":"https://api.occtoo.com","description":"Occtoo public API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"Sign in with the existing Occtoo Studio identity and selected organization.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.occtoo.com/oauth2/auth?audience=https%3A%2F%2Fapi-weu.occtoo.com","tokenUrl":"https://auth.occtoo.com/oauth2/token","scopes":{"openid":"Authenticate the user with OpenID Connect.","profile":"Read the user's basic profile.","email":"Read the user's email address.","offline":"Refresh the access token without another interactive sign-in."},"x-usePkce":"SHA-256","x-scalar-redirect-uri":"https://api.occtoo.com/docs/"}},"scopes":[],"schemeName":"kindeOAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Sign in with the existing Occtoo Studio identity and selected organization.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"kindeOAuth","name":"Authorization"}],"title":"kindeOAuth"},{"schemes":[{"scheme":{"type":"http","description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","description":"Occtoo organization API key.","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Occtoo organization API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi/ingest.json"},"subdomain":"occtoo","siteName":"Occtoo Documentation","title":"Start an asynchronous ingest - Occtoo Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T18:20:01.297Z","originalFileLocation":"api-reference/ingest/start-an-asynchronous-ingest.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=\"This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens. Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing. Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start an asynchronous ingest - Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens. Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing. Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Ingest+API\u0026amp;title=Start+an+asynchronous+ingest\u0026amp;description=%3CWarning%3EThis+endpoint+is+deprecated+and+will+be+removed+on+1+May+2027.+Use+%5Btyped+source+ingest%5D%28%2Fapi-reference%2Fingest%2Ftyped-source-entries%29+%28%60POST+%2Fv1%2Fsources\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=33f89ceab5553bee27487c305ce597d2a3163bbd3e459de207edd583aee2e8d8\">\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=\"Start an asynchronous ingest - Occtoo Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens. Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing. Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Ingest+API\u0026amp;title=Start+an+asynchronous+ingest\u0026amp;description=%3CWarning%3EThis+endpoint+is+deprecated+and+will+be+removed+on+1+May+2027.+Use+%5Btyped+source+ingest%5D%28%2Fapi-reference%2Fingest%2Ftyped-source-entries%29+%28%60POST+%2Fv1%2Fsources\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=33f89ceab5553bee27487c305ce597d2a3163bbd3e459de207edd583aee2e8d8\">\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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E36103\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ingest/start-an-asynchronous-ingest.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.occtoo.com/#organization\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.occtoo.com#website\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest#webpage\",\"url\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest\",\"name\":\"Start an asynchronous ingest\",\"description\":\"This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens. Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing. Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.\",\"dateModified\":\"2026-10-21T18:20:01.297Z\",\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ingest API\",\"item\":\"https://docs.occtoo.com/api-reference/ingest/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start an asynchronous ingest\",\"item\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest#apireference\",\"headline\":\"Start an asynchronous ingest\",\"name\":\"Start an asynchronous ingest\",\"description\":\"This endpoint is deprecated and will be removed on 1 May 2027. Use typed source ingest (POST /v1/sources/{sourceId}) instead. It validates values against source property types and uses tenant-level Application tokens. Validates and accepts source entries for asynchronous processing. A 202 response means the request was queued; it does not mean every entry has finished processing. Persist result.id as the ingest correlation id for diagnostics. There is currently no public status endpoint for this id. Do not retry a successful 202 response merely because downstream data is not visible yet.\",\"url\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest\",\"mainEntityOfPage\":{\"@id\":\"https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest#webpage\"},\"dateModified\":\"2026-10-21T18:20:01.297Z\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Occtoo Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Occtoo Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/get-started/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Getting started","pages":[{"title":"API overview","href":"/api-reference/overview"}]},{"group":"Application authentication","pages":[{"title":"Request an Application access token","sidebarTitle":"Application access token","openapi":"api-reference/openapi/applications.json POST /oauth2/token","playground":"interactive","href":"/api-reference/authentication/application-token"}]},{"group":"Ingest API","pages":[{"title":"Ingest","href":"/api-reference/ingest/overview"},{"title":"Ingest typed JSON into a source","deprecated":null,"version":null,"sidebarTitle":"Typed source entries","tag":"NEW","openapi":"/api-reference/openapi/ingest.json post /v1/sources/{sourceId}","href":"/api-reference/ingest/typed-source-entries"},{"title":"Read source entries by ID","deprecated":null,"version":null,"sidebarTitle":"Read source entries","openapi":"/api-reference/openapi/ingest.json get /v1/sources/{sourceId}/entries","href":"/api-reference/ingest/read-source-entries"},{"title":"Read a typed source entry","description":"Returns persisted entry values using current source-property types and delimiters. Localized values have one property item per language. lastUpdated timestamps are UTC; all translations of a property share its stored timestamp. Cleared scalars return null, cleared lists return an empty array. Unconfigured properties return raw strings with type null. Incompatible stored values return 409. Reads reflect completed ingestion, which may lag a successful ingest request.","deprecated":null,"version":null,"sidebarTitle":"Read source entry","openapi":"/api-reference/openapi/ingest.json get /v1/sources/{sourceId}/entries/{entryId}","href":"/api-reference/ingest/read-source-entry"},{"title":"Start an asynchronous ingest","deprecated":true,"version":null,"openapi":"/api-reference/openapi/ingest.json post /datasources/{dataSource}/import","href":"/api-reference/ingest/start-an-asynchronous-ingest"}]},{"group":"Events API","pages":[{"title":"Events","description":"Consume tenant-scoped CloudEvents by pull or live stream, and inspect the retained stream's current position.","href":"/api-reference/events/overview"},{"title":"List public event types and schema versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/event-types","href":"/api-reference/event-discovery/list-public-event-types-and-schema-versions"},{"title":"Pull public events","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events","href":"/api-reference/event-delivery/pull-public-events"},{"title":"Get public event stream metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/metadata","href":"/api-reference/event-delivery/get-public-event-stream-metadata"},{"title":"Stream public events using SSE","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/stream","href":"/api-reference/event-delivery/stream-public-events-using-sse"},{"title":"Get a versioned event data schema","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/schemas/{type}/{version}","href":"/api-reference/event-schemas/get-a-versioned-event-data-schema"},{"title":"Event stream (SSE)","href":"/api-reference/events/streaming"},{"title":"Durable consumers","href":"/api-reference/events/durable-consumers"},{"title":"Pull the next leased batch of events","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json post /v1/event-destinations/{id}/pull","href":"/api-reference/event-delivery/pull-the-next-leased-batch-of-events"},{"title":"Acknowledge a leased batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json post /v1/event-destinations/{id}/acknowledge","href":"/api-reference/event-delivery/acknowledge-a-leased-batch"}]},{"group":"Configuration API","pages":[{"title":"Configuration","href":"/api-reference/configuration/overview"},{"group":"Sources","pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources","href":"/api-reference/sources/list-sources"},{"title":"Create a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/sources","href":"/api-reference/sources/create-a-source"},{"title":"Get a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-source"},{"title":"Update source metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json patch /v1/sources/{sourceId}","href":"/api-reference/sources/update-source-metadata"},{"title":"Delete a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/sources/{sourceId}","href":"/api-reference/sources/delete-a-source"},{"title":"List source properties","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}/properties","href":"/api-reference/sources/list-source-properties"},{"title":"Get a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/get-a-source-property"},{"title":"Create or update a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/create-or-update-a-source-property"},{"title":"Delete a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/delete-a-source-property"}]},{"group":"Applications","pages":[{"title":"List applications","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications","href":"/api-reference/applications/list-applications"},{"title":"Create an application","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/applications","href":"/api-reference/applications/create-an-application"},{"title":"Discover application access options","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications/access-catalog","href":"/api-reference/applications/discover-application-access-options"},{"title":"Get an application","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications/{applicationId}","href":"/api-reference/applications/get-an-application"},{"title":"Replace application settings and access","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/applications/{applicationId}","href":"/api-reference/applications/replace-application-settings-and-access"},{"title":"Delete an application and revoke its credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/applications/{applicationId}","href":"/api-reference/applications/delete-an-application-and-revoke-its-credentials"}]},{"group":"Managed tags","pages":[{"title":"List managed tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags","href":"/api-reference/managed-tags/list-managed-tags"},{"title":"Create a managed tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/managed-tags","href":"/api-reference/managed-tags/create-a-managed-tag"},{"title":"Get a managed tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/get-a-managed-tag"},{"title":"Replace managed tag settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/replace-managed-tag-settings"},{"title":"Delete a managed tag and its values","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/delete-a-managed-tag-and-its-values"},{"title":"List managed tag values","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}/values","href":"/api-reference/managed-tag-values/list-managed-tag-values"},{"title":"Create a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/managed-tags/{managedTagId}/values","href":"/api-reference/managed-tag-values/create-a-managed-tag-value"},{"title":"Get a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/get-a-managed-tag-value"},{"title":"Replace a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/replace-a-managed-tag-value"},{"title":"Delete a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/delete-a-managed-tag-value"}]}]},{"group":"Data consumption","pages":[{"title":"Destination","href":"/api-reference/consumption/overview"}]}]},{"tab":"Integrations","icon":"plug","hidden":true,"pages":[{"title":"Integrations","href":"/integrations/providers/overview"}]},{"tab":"Changelog","icon":"list-check","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Announcements","icon":"bullhorn","pages":[{"title":"Announcements","href":"/announcements/overview"}]}]},"title":"Start an asynchronous ingest - Occtoo Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}