{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/schema.json","name":"4Minds","colors":{"primary":"#0A0050","light":"#D2EA47","dark":"#80AEFF"},"logo":{"light":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoBlack.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=de05cef735fb33fa8abd7ec4a3b7e992","dark":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoWhite.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=fa0befc8a3557581e6e5607c6c09e77e"},"favicon":{"light":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/logoBlackNoPadding.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=af25ea94e6530d7c568a88c4fb665c65","dark":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/logoWhiteNoPadding.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=41ee2a402a0d7a1a1d946029979acaa4"},"background":{"color":{"light":"#E9EFFF","dark":"#0C0C0C"}},"seo":{"metatags":{"google-site-verification":"2ole44wh7D3TkErjYO6eqaku3pjF0TpC4L9fG6nv0f8"}},"fonts":{"heading":{"family":"Roboto"},"body":{"family":"Open Sans"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"4minds-e9525117","hasAudioNarration":false,"actualSubdomain":"4minds-e9525117","customDomains":["docs.4minds.ai"],"gitSource":{"type":"github","owner":"4minds-ai","repo":"4minds-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae2a8a3776bbe78b17b67dc","collectionId":"6a2d8c2b-3195-45e8-8980-a721b2980e58","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2a8a3776bbe78b17b67dc"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2a8a3776bbe78b17b67dc","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"4Minds Features","count":26},{"language":"default","tag":"Developer Tools","count":18},{"language":"default","tag":"4Minds API","count":17},{"language":"default","tag":"4Minds API Endpoints","count":16},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"SYMI","count":7},{"language":"default","tag":"Datasets","count":6},{"language":"default","tag":"Conversations","count":5},{"language":"default","tag":"Intro","count":4},{"language":"default","tag":"Models","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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":true},"customCss":[{"filePath":"custom.css","content":".nav-logo{height:1.75rem!important;margin-left:-0.48rem!important}[class*=\"powered-by\"],[class*=\"PoweredBy\"],[class*=\"poweredBy\"],footer a[href*=\"mintlify.com\"],footer a[href*=\"mintlify\"]{display:none!important;visibility:hidden!important;opacity:0!important;height:0!important;width:0!important;overflow:hidden!important}#custom-legal-links a,#custom-legal-links .separator{margin-right:8px}#custom-legal-links .separator{margin-left:8px;opacity:0.6}footer [class*=\"legal\"]>span:first-child,footer [class*=\"legal\"]>div:first-child,footer h3,footer h4,footer h5{display:none!important}footer,footer *,footer::before,footer::after,footer *::before,footer *::after,[class*=\"footer\"],[class*=\"footer\"] *,[class*=\"footer\"]::before,[class*=\"footer\"]::after,[class*=\"footer\"] *::before,[class*=\"footer\"] *::after{border:none!important;border-top:none!important;border-bottom:none!important;border-left:none!important;border-right:none!important}footer hr,[class*=\"footer\"] hr{display:none!important}footer,footer>div,footer [class*=\"footer\"]{display:flex!important;flex-direction:column!important;align-items:center!important;width:100%!important;gap:5px!important}footer [class*=\"legal\"],footer nav,footer ul{display:flex!important;flex-direction:row!important;align-items:center!important;justify-content:center!important;gap:80px!important;flex-wrap:nowrap!important;white-space:nowrap!important;list-style:none!important;padding:0!important;margin:0!important;width:auto!important;max-width:100%!important;overflow-x:auto!important}footer [class*=\"legal\"] a,footer nav a,footer ul a,footer a[href*=\"4minds.ai\"]{display:inline-block!important;margin:0!important;padding:0!important;white-space:nowrap!important}footer [class*=\"legal\"] a:not(:last-child)::after,footer nav a:not(:last-child)::after,footer ul li:not(:last-child)::after,footer a[href*=\"4minds.ai\"]:not(:last-of-type)::after{content:\"\"!important;margin-left:0!important;margin-right:0!important}footer [class*=\"copyright\"],footer p:last-child,footer div:last-child{display:block!important;text-align:center!important;padding:10px 0!important;margin-top:5px!important;border:none!important;color:inherit!important;font-size:14px!important;width:100%!important;order:999!important}"}],"page":{"pagePath":"api-reference/datasets/upload-files-to-an-existing-dataset","slug":"/api-reference/datasets/upload-files-to-an-existing-dataset","pageMetadata":{"title":"Upload files to an existing dataset","description":"Adds files to a dataset and starts processing them. Files already in the dataset are\nskipped and listed in `skipped_files`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset/upload","href":"/api-reference/datasets/upload-files-to-an-existing-dataset","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: [\"Adds files to a dataset and starts processing them. Files already in the dataset are\\nskipped and listed in \", _jsx(_components.code, {\n children: \"skipped_files\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upload files to an existing dataset","description":"Adds files to a dataset and starts processing them. Files already in the dataset are\nskipped and listed in `skipped_files`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset/upload","href":"/api-reference/datasets/upload-files-to-an-existing-dataset","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/4minds-e9525117/e573413487c50684/custom-footer.js"],"openApiReferenceData":{"operation":{"tags":["Datasets"],"summary":"Upload files to an existing dataset","operationId":"uploadDatasetFiles","description":"Adds files to a dataset and starts processing them. Files already in the dataset are\nskipped and listed in `skipped_files`.\n","requestBody":"cfa68597-b395-4e28-b20a-453ca25c98da","responses":{"200":"4b3c85c9-8d9b-4584-b48d-ba1f5f3287b9","401":"35ed92f3-6051-4669-9ef1-ca9197aebd42","404":"02d54d77-ede1-4d65-9041-08816faa850a","422":"0de7dd29-a041-4941-ba72-ab231dc498c1"},"method":"post","type":"path","servers":["52cd19fe-cca3-4055-8983-37e09f4c8fcf"],"security":["c4f5b703-26ec-49d2-8a81-ae07c451d9ac"],"path":"/api/v1/user/dataset/upload","baseUrlOptions":["https://api.4minds.ai"],"title":"Upload files to an existing dataset","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["dataset_id","files"],"properties":{"dataset_id":{"type":"integer","isRequired":true,"uniqueKey":"dataset_id","typeLabel":"integer"},"files":{"type":"array","items":{"type":"string","format":"binary","uniqueKey":"files.items.[INDEX]","typeLabel":"file"},"isRequired":true,"uniqueKey":"files","typeLabel":"file[]"}},"uniqueKey":"","typeLabel":"object"},"encoding":{"files":{"contentType":"application/octet-stream"}},"examples":{"Example":{"title":"Example","value":{"dataset_id":123,"files":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4b3c85c9-8d9b-4584-b48d-ba1f5f3287b9":{"description":"Upload receipt.","content":{"application/json":{"schema":{"type":"object","required":["success","processing_started","processing_error","dataset_id","files_uploaded","files_failed","files_skipped","total_size","failed_files","skipped_files"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"processing_started":{"type":"boolean","description":"`false` when every file was skipped.","isRequired":true,"uniqueKey":"processing_started","typeLabel":"boolean"},"processing_error":{"description":"`null` when processing started normally.","isRequired":true,"uniqueKey":"processing_error","typeLabel":"any"},"dataset_id":{"type":"integer","isRequired":true,"uniqueKey":"dataset_id","typeLabel":"integer"},"files_uploaded":{"type":"integer","isRequired":true,"uniqueKey":"files_uploaded","typeLabel":"integer"},"files_failed":{"type":"integer","isRequired":true,"uniqueKey":"files_failed","typeLabel":"integer"},"files_skipped":{"type":"integer","isRequired":true,"uniqueKey":"files_skipped","typeLabel":"integer"},"total_size":{"type":"integer","description":"Bytes uploaded in this request.","isRequired":true,"uniqueKey":"total_size","typeLabel":"integer"},"failed_files":{"description":"`null` when no file failed.","isRequired":true,"uniqueKey":"failed_files","typeLabel":"any"},"skipped_files":{"oneOf":[{"type":"array","items":{"type":"object","required":["filename","reason","existing_file_id","existing_file_name"],"properties":{"filename":{"type":"string","isRequired":true,"uniqueKey":"skipped_files.oneOf.0.items.[INDEX].filename","typeLabel":"string"},"reason":{"type":"string","examples":["already_exists"],"isRequired":true,"uniqueKey":"skipped_files.oneOf.0.items.[INDEX].reason","typeLabel":"string"},"existing_file_id":{"type":"integer","isRequired":true,"uniqueKey":"skipped_files.oneOf.0.items.[INDEX].existing_file_id","typeLabel":"integer"},"existing_file_name":{"type":"string","isRequired":true,"uniqueKey":"skipped_files.oneOf.0.items.[INDEX].existing_file_name","typeLabel":"string"}},"uniqueKey":"skipped_files.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"skipped_files.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["filename","reason","existing_file_id","existing_file_name"],"properties":{"filename":{"type":"string"},"reason":{"type":"string","examples":["already_exists"]},"existing_file_id":{"type":"integer"},"existing_file_name":{"type":"string"}}},"isRequired":true,"uniqueKey":"skipped_files.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"skipped_files","typeLabel":"object[] | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"processing_started":true,"processing_error":"\u003cunknown>","dataset_id":123,"files_uploaded":123,"files_failed":123,"files_skipped":123,"total_size":123,"failed_files":"\u003cunknown>","skipped_files":[{"filename":"\u003cstring>","reason":"already_exists","existing_file_id":123,"existing_file_name":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"35ed92f3-6051-4669-9ef1-ca9197aebd42":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"Authentication required"},"examples":{"Example":{"title":"Example","value":{"detail":"Authentication required"}}},"exampleType":"examples"}},"exampleType":"examples"},"02d54d77-ede1-4d65-9041-08816faa850a":{"description":"The dataset doesn't exist, or you don't have access to it.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"Dataset 999999999 not found or access denied"},"examples":{"Example":{"title":"Example","value":{"detail":"Dataset 999999999 not found or access denied"}}},"exampleType":"examples"}},"exampleType":"examples"},"0de7dd29-a041-4941-ba72-ab231dc498c1":{"description":"`dataset_id` or `files` is missing, or `dataset_id` isn't an integer.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":[{"type":"missing","loc":["body","files"],"msg":"Field required","input":null}]},"examples":{"Example":{"title":"Example","value":{"detail":[{"type":"missing","loc":["body","files"],"msg":"Field required","input":null}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c4f5b703-26ec-49d2-8a81-ae07c451d9ac":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"52cd19fe-cca3-4055-8983-37e09f4c8fcf":{"url":"https://api.4minds.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"4minds-e9525117","siteName":"4Minds","title":"Upload files to an existing dataset - 4Minds","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T19:58:06.914Z","originalFileLocation":"api-reference/datasets/upload-files-to-an-existing-dataset.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=\"Adds files to a dataset and starts processing them. Files already in the dataset are skipped and listed in skipped_files.\">\u003cmeta data-mint-head name=\"application-name\" content=\"4Minds\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload files to an existing dataset - 4Minds\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds files to a dataset and starts processing them. Files already in the dataset are skipped and listed in skipped_files.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"4Minds\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://4minds-e9525117.mintlify.app/_mintlify/api/og/v2?division=Datasets\u0026amp;title=Upload+files+to+an+existing+dataset\u0026amp;description=Adds+files+to+a+dataset+and+starts+processing+them.+Files+already+in+the+dataset+are%0Askipped+and+listed+in+%60skipped_files%60.%0A\u0026amp;theme=a08d550f1325906504303eba\u0026amp;signature=58496693818e26fbb02ee5ef940ac178ec39c3b7856721611328604479eadbc3\">\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=\"Upload files to an existing dataset - 4Minds\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds files to a dataset and starts processing them. Files already in the dataset are skipped and listed in skipped_files.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://4minds-e9525117.mintlify.app/_mintlify/api/og/v2?division=Datasets\u0026amp;title=Upload+files+to+an+existing+dataset\u0026amp;description=Adds+files+to+a+dataset+and+starts+processing+them.+Files+already+in+the+dataset+are%0Askipped+and+listed+in+%60skipped_files%60.%0A\u0026amp;theme=a08d550f1325906504303eba\u0026amp;signature=58496693818e26fbb02ee5ef940ac178ec39c3b7856721611328604479eadbc3\">\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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"4Minds\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0050\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"2ole44wh7D3TkErjYO6eqaku3pjF0TpC4L9fG6nv0f8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/datasets/upload-files-to-an-existing-dataset.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.4minds.ai/#organization\",\"name\":\"4Minds\",\"url\":\"https://docs.4minds.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoBlack.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=de05cef735fb33fa8abd7ec4a3b7e992\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.4minds.ai#website\",\"name\":\"4Minds\",\"url\":\"https://docs.4minds.ai\",\"publisher\":{\"@id\":\"https://docs.4minds.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset#webpage\",\"url\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset\",\"name\":\"Upload files to an existing dataset\",\"description\":\"Adds files to a dataset and starts processing them. Files already in the dataset are skipped and listed in skipped_files.\",\"dateModified\":\"2026-10-23T19:58:06.914Z\",\"isPartOf\":{\"@id\":\"https://docs.4minds.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developer Tools\",\"item\":\"https://docs.4minds.ai/cloud-shell\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"4Minds API\",\"item\":\"https://docs.4minds.ai/api-overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"4Minds API Endpoints\",\"item\":\"https://docs.4minds.ai/api-reference/models/list-models\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Datasets\",\"item\":\"https://docs.4minds.ai/api-reference/datasets/list-datasets\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Upload files to an existing dataset\",\"item\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset#apireference\",\"headline\":\"Upload files to an existing dataset\",\"name\":\"Upload files to an existing dataset\",\"description\":\"Adds files to a dataset and starts processing them. Files already in the dataset are skipped and listed in skipped_files.\",\"url\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset\",\"mainEntityOfPage\":{\"@id\":\"https://docs.4minds.ai/api-reference/datasets/upload-files-to-an-existing-dataset#webpage\"},\"dateModified\":\"2026-10-23T19:58:06.914Z\",\"publisher\":{\"@id\":\"https://docs.4minds.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.4minds.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"4Minds\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"4Minds","nav":{"global":null,"groups":[{"group":"Intro","icon":"book-open","pages":[{"mode":"wide","title":"What is 4Minds","href":"/introduction"},{"title":"Key Advantages","href":"/key-advantages"},{"title":"Platform Architecture","href":"/platform-architecture"},{"title":"Security and Compliance","href":"/security"}]},{"group":"Getting Started with 4Minds","icon":"rocket","pages":[{"title":"Quick Start Guide","href":"/quickstart"}]},{"group":"Marketplace","icon":"store","pages":[{"group":"AWS","pages":[{"title":"AWS Marketplace: Helm Deployment","href":"/aws-marketplace"}]}]},{"group":"4Minds Features","icon":"sparkles","pages":[{"title":"Manage and Interact with Your Model","href":"/control-center"},{"title":"Explore the Model Dashboard","href":"/models"},{"title":"Evaluate your Model Performance","href":"/evaluations"},{"title":"Manage your Datasets","href":"/datasets"},{"title":"Personas","href":"/persona-configuration"},{"title":"Monitor Your Logs","hidden":true,"href":"/logging"},{"group":"Integrations","pages":[{"title":"Add Integrations \u0026 Data Sources","href":"/integrations"},{"title":"AWS Integrations","href":"/aws-integrations"},{"title":"Amazon RDS","href":"/rds"},{"title":"Amazon Redshift","href":"/redshift"},{"title":"Microsoft Fabric","href":"/microsoft-fabric"},{"title":"Microsoft Foundry","href":"/microsoft-foundry"},{"title":"Microsoft 365 Copilot","href":"/microsoft-365-copilot"},{"title":"Amazon Bedrock","href":"/bedrock"},{"title":"Databricks","href":"/databricks"},{"title":"dbt","href":"/dbt"},{"title":"Gong","href":"/gong"},{"title":"HubSpot","href":"/hubspot"}]},{"title":"Stay Updated with Real-Time Notifications","href":"/notifications"},{"title":"Organize your Teams","href":"/teams"},{"group":"SYMI","pages":[{"title":"SYMI Agentic AI Platform","href":"/symi"},{"title":"Memory","href":"/symi/memory"},{"title":"Persistent Workspace","href":"/symi/persistent-workspace"},{"title":"Skills, Sub-Agents, and Tools","href":"/symi/skills-system"},{"title":"Workspace Mirror","href":"/symi/workspace-mirror"},{"title":"Set up Workspace Mirror","href":"/symi/workspace-mirror-setup"},{"title":"Security \u0026 Isolation","href":"/symi/security-and-isolation"}]}]},{"group":"What's New in 4Minds","icon":"newspaper","pages":[{"title":"Changelog \u0026 Release Notes","href":"/changelog"}]},{"group":"Key Terms and Concepts in 4Minds","icon":"book","pages":[{"title":"Glossary","href":"/glossary"}]},{"group":"Developer Tools","icon":"code","pages":[{"title":"Cloud Shell","href":"/cloud-shell"},{"group":"4Minds API","pages":[{"title":"4Minds API Overview","href":"/api-overview"},{"group":"4Minds API Endpoints","pages":[{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/model","href":"/api-reference/models/list-models"},{"title":"Create a fine-tuned model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/model","href":"/api-reference/models/create-a-fine-tuned-model"},{"title":"Get a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/model/{model_id}","href":"/api-reference/models/get-a-model"},{"title":"Delete a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/model/{model_id}","href":"/api-reference/models/delete-a-model"}]},{"group":"Conversations","pages":[{"title":"List conversations for a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations","href":"/api-reference/conversations/list-conversations-for-a-model"},{"title":"Create a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/conversations","href":"/api-reference/conversations/create-a-conversation"},{"title":"Rename a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/user/conversations/{conversation_id}","href":"/api-reference/conversations/rename-a-conversation"},{"title":"Delete a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/conversations/{conversation_id}","href":"/api-reference/conversations/delete-a-conversation"},{"title":"List messages in a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations/{conversation_id}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation"}]},{"group":"Datasets","pages":[{"title":"List datasets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset","href":"/api-reference/datasets/list-datasets"},{"title":"Create a dataset from files and/or URLs","description":"Creates a dataset from uploaded files, URLs, or both. At least one file or URL is required.\n\nThe dataset is returned straight away with `status` and `graph_status` set to `preparing`;\nprocessing continues in the background. Poll Get a dataset until `graph_status` is `ready`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset","href":"/api-reference/datasets/create-a-dataset-from-files-andor-urls"},{"title":"Upload files to an existing dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset/upload","href":"/api-reference/datasets/upload-files-to-an-existing-dataset"},{"title":"Get a dataset","description":"Returns one dataset, looked up by numeric ID or by exact name. Soft-deleted datasets are returned too.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset/{dataset_id}","href":"/api-reference/datasets/get-a-dataset"},{"title":"Delete a dataset (soft by default)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/dataset/{dataset_id}","href":"/api-reference/datasets/delete-a-dataset-soft-by-default"},{"title":"List files in a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset/{dataset_id}/files","href":"/api-reference/datasets/list-files-in-a-dataset"}]},{"group":"Inference","pages":[{"title":"Run an inference query (streaming SSE)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/inference","href":"/api-reference/inference/run-an-inference-query-streaming-sse"}]}]},{"title":"4Minds API Reference Old","hidden":true,"href":"/api-reference"}]}]}]},"basePath":"","title":"Upload files to an existing dataset - 4Minds","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}