You can use this endpoint to upload your local file and then use the file_key you obtained to create a data source through the Create data source endpoint.Only files with the following extensions are supported: .csv, .tsv, .md, .mdx, .json, .txt, .pdf, .pptx, .ppt, .doc, .docx, .xls, or .xlsx.
For optimal upload efficiency, we recommend using this endpoint for files smaller than 1 MB. For files larger than 1 MB, please initiate a multipart upload task.
The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.
The file to be uploaded. This is a required field and should contain the file data. For example, --form 'file=@"/Users/jiaoqi/Downloads/0f9a7ebd-7a2a-454a-8cd9-96accffa3107.csv"'.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Powerdrill","colors":{"primary":"#803FE2","light":"#9E6CE8","dark":"#803FE2"},"logo":{"light":"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/light_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=dc2f74f20167a362fea696e338f33414","dark":"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/dark_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=695f412bda840aa700144b31bb1ec4bb"},"favicon":"https://mintcdn.com/powerdrill-55/bBGveC8zr4vD5DAR/favicon.png?fit=max\u0026auto=format\u0026n=bBGveC8zr4vD5DAR\u0026q=85\u0026s=6f84811bf7e1eefae3b7cca21207dc09","background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/powerdrill-55/background.png"},"navbar":{"links":[{"href":"https://github.com/powerdrillai","label":"GitHub"}],"primary":{"type":"button","label":"Get Started","href":"https://powerdrill.ai"}},"footer":{"socials":{"github":"https://github.com/powerdrillai","youtube":"https://www.youtube.com/@powerdrill_ai","twitter":"https://twitter.com/powerdrillai","discord":"https://discord.gg/ZsyyD5ysRC","linkedin":"https://www.linkedin.com/company/powerdrill"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"powerdrill-55","hasAudioNarration":false,"actualSubdomain":"powerdrill-55","customDomains":["docs.powerdrill.ai"],"gitSource":{"type":"github","owner":"powerdrillai","repo":"powerdrill_docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a676e74b2a6a80119146f2c","collectionId":"16d59170-1e02-488c-bffd-27d8bdcf9eb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a676e74b2a6a80119146f2c"},"entitlements":{},"buildId":"6a676e74b2a6a80119146f2c:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":54},{"language":"default","tag":"Open API V2","count":28},{"language":"default","tag":"Open API V1 (Deprecated)","count":26},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Data sources","count":12},{"language":"default","tag":"Datasets","count":12},{"language":"default","tag":"Sessions","count":12},{"language":"default","tag":"Enterprise","count":11},{"language":"default","tag":"Features","count":9},{"language":"default","tag":"Overview","count":8}]},"assistantConfig":{},"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":[],"page":{"pagePath":"api-reference/v2/upload-file","slug":"/api-reference/v2/upload-file","pageMetadata":{"openapi":"post /v2/team/file/upload-datasource","description":"Uploads a file. ","mode":"wide","title":"Upload local file","href":"/api-reference/v2/upload-file"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Uploads a file.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`introduction`,children:`Introduction`}),`\n`,_jsxs(_components.p,{children:[`You can use this endpoint to upload your local file and then use the `,_jsx(_components.code,{children:`file_key`}),` you obtained to create a data source through the `,_jsx(_components.a,{href:`/api-reference/v2/create-data-source`,children:`Create data source`}),` endpoint.`]}),`\n`,_jsxs(_components.p,{children:[`Only files with the following extensions are supported: `,_jsx(_components.strong,{children:`.csv`}),`, `,_jsx(_components.strong,{children:`.tsv`}),`, `,_jsx(_components.strong,{children:`.md`}),`, `,_jsx(_components.strong,{children:`.mdx`}),`, `,_jsx(_components.strong,{children:`.json`}),`, `,_jsx(_components.strong,{children:`.txt`}),`, `,_jsx(_components.strong,{children:`.pdf`}),`, `,_jsx(_components.strong,{children:`.pptx`}),`, `,_jsx(_components.strong,{children:`.ppt`}),`, `,_jsx(_components.strong,{children:`.doc`}),`, `,_jsx(_components.strong,{children:`.docx`}),`, `,_jsx(_components.strong,{children:`.xls`}),`, or `,_jsx(_components.strong,{children:`.xlsx`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`For optimal upload efficiency, we recommend using this endpoint for files `,_jsx(_components.strong,{children:`smaller than 1 MB`}),`. For files larger than 1 MB, please initiate a `,_jsx(_components.a,{href:`/api-reference/v2/initiate-multipart-upload`,children:`multipart upload`}),` task.`]})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example request:`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`curl --location 'http://ai.data.cloud/api/v2/team/file/upload-datasource' \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`--header 'x-pd-api-key: \u003capi-key>' \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`--header 'x-pd-external-trace-id;' \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`--header 'Cookie: Cookie_1=value; metabase.DEVICE=f3cb3dbb-ef62-4026-845e-1480431c751d' \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`--form 'file=@\"/Users/username/Downloads/c5168946-8f1a-4c92-a167-5e3be57745be.csv\"' \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`--form 'user_id=\"tmm-cm5ao3yoe00zm01l1u1e7p3pj\"'`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`17`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"http://ai.data.cloud/api/v2/team/file/upload-datasource\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'user_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'tmm-cm5ao3yoe00zm01l1u1e7p3pj'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`files`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'file'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'c5168946-8f1a-4c92-a167-5e3be57745be.csv'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`open`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'/Users/jiaoqi/Downloads/c5168946-8f1a-4c92-a167-5e3be57745be.csv'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'rb'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'text/csv'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`))`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-pd-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'\u003capi-key>'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-pd-external-trace-id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`''`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Cookie'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Cookie_1=value; metabase.DEVICE=f3cb3dbb-ef62-4026-845e-1480431c751d'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.request(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, url, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`files`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`files)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.text)`})]}),`\n`]})})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example response:`})}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"file_object_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/tmp/sdgsagdsgsadgasdg.csv\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v2/team/file/upload-datasource","description":"Uploads a file. ","mode":"wide","title":"Upload local file","href":"/api-reference/v2/upload-file"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Introduction","slug":"introduction","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Upload local file","deprecated":false,"description":"Uploads a file. ","tags":["File"],"parameters":["079e00e6-d438-4bf3-a4ca-806da37685a5"],"requestBody":"91f929a9-84b6-4755-95f5-c4459caee581","responses":{"200":"352d4adf-fdae-4e13-8530-24a0aa32ac52"},"security":["67699b50-0386-4bc5-81fc-01d1f0a46c2a"],"method":"post","type":"path","servers":["81ddd8d1-e0c9-427d-9d45-c7531fb084ca"],"path":"/v2/team/file/upload-datasource","baseUrlOptions":["https://ai.data.cloud/api"],"title":"Upload local file","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"079e00e6-d438-4bf3-a4ca-806da37685a5":{"name":"x-pd-external-trace-id","in":"header","description":"The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.","required":false,"example":"","schema":{"type":"string","isRequired":false,"description":"The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"format":"binary","type":"string","description":"The file to be uploaded. This is a required field and should contain the file data. For example, `--form 'file=@\"/Users/jiaoqi/Downloads/0f9a7ebd-7a2a-454a-8cd9-96accffa3107.csv\"'`.","example":"","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"user_id":{"description":"Your user ID, which uniquely identifies you within your team. To obtain your ID:\n\n- If you're the team admin, refer to [Check user information](/enterprise/users#check-user-information).\n- If you're a system or virtual user, ask your team admin to check your user ID by referring to [Check user information](/enterprise/users#check-user-information).","example":"","type":"string","isRequired":true,"uniqueKey":"user_id","typeLabel":"string"}},"required":["file","user_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"","user_id":""}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"352d4adf-fdae-4e13-8530-24a0aa32ac52":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Status code. **0** indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to [Error Codes](/api-reference/error-codes).","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"data":{"type":"object","properties":{"file_object_key":{"type":"string","description":"The object storage path to the file.","isRequired":true,"uniqueKey":"data.file_object_key","typeLabel":"string"}},"required":["file_object_key"],"description":"The returned data object.","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data","code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":0,"data":{"file_object_key":"/tmp/sdgsagdsgsadgasdg.csv"}},"examples":{"Example":{"title":"Example","value":{"code":0,"data":{"file_object_key":"/tmp/sdgsagdsgsadgasdg.csv"}}}},"exampleType":"examples"}},"headers":{"x-pd-trace-id":{"example":"","required":true,"description":"The trace ID returned by Powerdrill. If a failure occurs, you can provide it to the Powerdrill team to assist with troubleshooting.","schema":{"type":"string"}}},"exampleType":"examples"}},"security":{"67699b50-0386-4bc5-81fc-01d1f0a46c2a":{"apikey-header-x-pd-api-key":{"type":"apiKey","in":"header","name":"x-pd-api-key","scopes":[]}}},"servers":{"81ddd8d1-e0c9-427d-9d45-c7531fb084ca":{"url":"https://ai.data.cloud/api","description":"体验环境"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-pd-api-key","scopes":[]},"schema":{"title":"x-pd-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikey-header-x-pd-api-key","name":"x-pd-api-key"}],"title":"apikey-header-x-pd-api-key"}]},"originalFileLocation":"v2-openapi.json"},"subdomain":"powerdrill-55","siteName":"Powerdrill","title":"Upload local file - Powerdrill","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T22:54:09.474Z","originalFileLocation":"api-reference/v2/upload-file.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=\"Uploads a file.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Powerdrill\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload local file - Powerdrill\">\u003cmeta data-mint-head property=\"og:description\" content=\"Uploads a file.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Powerdrill\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.powerdrill.ai/api-reference/v2/upload-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://powerdrill-55.mintlify.app/_mintlify/api/og/v2?division=Files\u0026amp;title=Upload+local+file\u0026amp;description=Uploads+a+file.+\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=871dca47c484946f3e53c82a1ad276c551830f05d0add2261ea2089c214c8993\">\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 local file - Powerdrill\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Uploads a file.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://powerdrill-55.mintlify.app/_mintlify/api/og/v2?division=Files\u0026amp;title=Upload+local+file\u0026amp;description=Uploads+a+file.+\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=871dca47c484946f3e53c82a1ad276c551830f05d0add2261ea2089c214c8993\">\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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Powerdrill\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#803FE2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.powerdrill.ai/api-reference/v2/upload-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/upload-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.powerdrill.ai/#organization\",\"name\":\"Powerdrill\",\"url\":\"https://docs.powerdrill.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/light_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=dc2f74f20167a362fea696e338f33414\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.powerdrill.ai#website\",\"name\":\"Powerdrill\",\"url\":\"https://docs.powerdrill.ai\",\"publisher\":{\"@id\":\"https://docs.powerdrill.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file#webpage\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file\",\"name\":\"Upload local file\",\"description\":\"Uploads a file.\",\"dateModified\":\"2026-01-06T22:54:09.474Z\",\"isPartOf\":{\"@id\":\"https://docs.powerdrill.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Powerdrill\",\"item\":\"https://docs.powerdrill.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload local file\",\"item\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file#apireference\",\"headline\":\"Upload local file\",\"name\":\"Upload local file\",\"description\":\"Uploads a file.\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file\",\"mainEntityOfPage\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/upload-file#webpage\"},\"dateModified\":\"2026-01-06T22:54:09.474Z\",\"publisher\":{\"@id\":\"https://docs.powerdrill.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.powerdrill.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Powerdrill\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Powerdrill","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/get-started/introduction"}]},{"tab":"Enterprise","pages":[{"title":"Enterprise","href":"/enterprise/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Open API V2","icon":"dice-two","groups":[{"group":"Overview","pages":[{"title":"Overview","icon":"book","href":"/api-reference/v2/overview"},{"title":"Authentication","icon":"key","href":"/api-reference/v2/authentication"},{"title":"Streaming","icon":"grip-lines","href":"/api-reference/v2/streaming"},{"title":"Error Codes","icon":"screwdriver-wrench","href":"/api-reference/error-codes"},{"title":"Create subscriptions","icon":"cart-shopping","href":"/api-reference/v2/create-subscription"}]},{"group":"Developer Guides","pages":[{"title":"Quick Start","icon":"rocket","href":"/developer-guides/quick-start-v2"},{"title":"Check Status of Data Sources","icon":"check","href":"/api-reference/v2/how-to-check-data-sources"}]},{"group":"Datasets","pages":[{"openapi":"post /v2/team/datasets","title":"Create dataset","href":"/api-reference/v2/create-dataset"},{"openapi":"get /v2/team/datasets/{id}/status","mode":"wide","title":"Get status summary of data sources in dataset","href":"/api-reference/v2/get-dataset-status"},{"openapi":"get /v2/team/datasets/{id}/overview","mode":"wide","title":"Get dataset overview","href":"/api-reference/v2/get-dataset-overview"},{"openapi":"get /v2/team/datasets","mode":"wide","title":"List datasets","href":"/api-reference/v2/list-datasets"},{"openapi":"post /v2/team/datasets/{id}","title":"Modify dataset","href":"/api-reference/v2/modify-dataset"},{"openapi":"delete /v2/team/datasets/{id}","title":"Delete dataset","href":"/api-reference/v2/delete-dataset"}]},{"group":"Data sources","pages":[{"openapi":"POST /v2/team/datasets/{id}/datasources","title":"Create data source","href":"/api-reference/v2/create-data-source"},{"openapi":"POST /v2/team/datasources","title":"Create data source without specifying a dataset","href":"/api-reference/v2/create-data-source-without-dataset"},{"openapi":"get /v2/team/datasets/{dataset_id}/datasources/{datasource_id}","mode":"wide","title":"Get data source","href":"/api-reference/v2/get-data-source"},{"openapi":"get /v2/team/datasets/{id}/datasources","mode":"wide","title":"List data sources","href":"/api-reference/v2/list-data-sources"},{"openapi":"delete /v2/team/datasets/{dataset_id}/datasources/{datasource_id}","title":"Delete data source","href":"/api-reference/v2/delete-data-source"},{"openapi":"post /v2/team/datasets/{dataset_id}/datasources/{datasource_id}/presign","title":"Presign data source ","description":"If you want to download a data source, you can use this endpoint to generate a presigned URL, which allows you to download the data source via the URL.\n\nPresigned URLs have an expiration period. Be sure to download your data sources before the URL expires.","href":"/api-reference/v2/presign-data-source"}]},{"group":"Files","pages":[{"openapi":"post /v2/team/file/upload-datasource","mode":"wide","title":"Upload local file","href":"/api-reference/v2/upload-file"},{"openapi":"post /v2/team/file/init-multipart-upload","title":"Initiate multipart upload","description":"Initiates a multipart upload task for local files in multipart mode. Only files in the following formats are supported: **.csv**, **.tsv**, **.md**, **.mdx**, **.json**, **.txt**, **.pdf**, **.pptx**, **.docx**, **.xls**, or **.xlsx**.\n\n## Important notes\n\nWhen you call this endpoint, Cloud Object Storage, for example, AWS S3, generates and returns a unique upload ID to identify the multipart upload task. This ID is required when you call the [Complete multipart upload](/api-reference/v2/complete-multipart-upload) endpoint.","href":"/api-reference/v2/initiate-multipart-upload"},{"openapi":"post /v2/team/file/complete-multipart-upload","title":"Complete multipart upload","href":"/api-reference/v2/complete-multipart-upload"}]},{"group":"Sessions","pages":[{"openapi":"post /v2/team/sessions","title":"Create session","href":"/api-reference/v2/create-session"},{"openapi":"get /v2/team/sessions/{id}","mode":"wide","title":"Get session","href":"/api-reference/v2/get-session"},{"openapi":"get /v2/team/sessions/{id}/history","mode":"wide","title":"Get job history in session","href":"/api-reference/v2/get-job-history"},{"openapi":"get /v2/team/sessions","mode":"wide","title":"List sessions","href":"/api-reference/v2/list-sessions"},{"openapi":"post /v2/team/sessions/{id}","title":"Modify session","href":"/api-reference/v2/modify-session"},{"openapi":"delete /v2/team/sessions/{id}","title":"Delete session","href":"/api-reference/v2/delete-session"}]},{"group":"Jobs","pages":[{"openapi":"post /v2/team/jobs","title":"Create job","href":"/api-reference/v2/create-job"}]}]},{"anchor":"Open API V1 (Deprecated)","icon":"dice-one","pages":[{"title":"Open API V1 (Deprecated)","href":"/api-reference/overview"}]}]}]},"title":"Upload local file - Powerdrill","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-kQh739Uz.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}