Vaero file endpoints allow you to upload one or more files. These files contain the sample text for fine-tuning to create a style.The files can be .txt or .docx files. Convert other file formats to .txt or .docx before uploading.Each file should represent one document (one blog post, one report, one email, etc.) If you have want to train on multiple documents, upload them as separate files. For example, if you want to fine-tune on 5 blog posts, upload these as 5 separate files.When a file is uploaded, the response includes the file ID to use for the fine-tuning endpoint. You can also list your uploaded files.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Vaero AI Style API","colors":{"primary":"#2B4FF3","light":"#31A5F4","dark":"#0F1022"},"favicon":"https://mintcdn.com/vaero/y2t9VRBorN0cAjfx/favicon.svg?fit=max\u0026auto=format\u0026n=y2t9VRBorN0cAjfx\u0026q=85\u0026s=ffff06644fe0fbd502e1234a6d89233a","logo":{"light":"https://mintcdn.com/vaero/r6BYlJMvZni7Gu_F/logo/vaero_logo.png?fit=max\u0026auto=format\u0026n=r6BYlJMvZni7Gu_F\u0026q=85\u0026s=79a6cbe3dd3f76311eeec327bfe7aafe","dark":"https://mintcdn.com/vaero/r6BYlJMvZni7Gu_F/logo/vaero_logo_dark.png?fit=max\u0026auto=format\u0026n=r6BYlJMvZni7Gu_F\u0026q=85\u0026s=37fb4ff7aba905bf84ec3d5eff4e1dd0"},"navbar":{"links":[{"label":"Support","href":"mailto:hello@vaero.co"}],"primary":{"type":"button","label":"Home","href":"https://vaeroai.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vaero","hasAudioNarration":false,"actualSubdomain":"vaero","customDomains":["docs.vaero.co"],"gitSource":{"type":"github","owner":"vaerohq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a7be9dc811f81fc94686e9f","collectionId":"aa9636d8-cb83-451d-a92e-e088c0e45afb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a7be9dc811f81fc94686e9f"},"entitlements":{},"buildId":"6a7be9dc811f81fc94686e9f:success","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Files","count":5},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Fine Tuning","count":3},{"language":"default","tag":"Support","count":2},{"language":"default","tag":"Styling","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"features/files","slug":"/features/files","pageMetadata":{"title":"Files","description":"Upload files of writing samples for fine-tuning","href":"/features/files"},"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: \"Upload files of writing samples for fine-tuning\"\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={p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`basics`,children:`Basics`}),`\n`,_jsx(_components.p,{children:`Vaero file endpoints allow you to upload one or more files. These files contain the sample text for fine-tuning to create a style.`}),`\n`,_jsx(_components.p,{children:`The files can be .txt or .docx files. Convert other file formats to .txt or .docx before uploading.`}),`\n`,_jsx(_components.p,{children:`Each file should represent one document (one blog post, one report, one email, etc.) If you have want to train on multiple documents, upload them as separate files. For example, if you want to fine-tune on 5 blog posts, upload these as 5 separate files.`}),`\n`,_jsx(_components.p,{children:`When a file is uploaded, the response includes the file ID to use for the fine-tuning endpoint. You can also list your uploaded files.`})]})}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":{"title":"Files","description":"Upload files of writing samples for fine-tuning","href":"/features/files"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Basics","slug":"basics","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vaero","siteName":"Vaero AI Style API","title":"Files - Vaero AI Style API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-28T04:51:03.412Z","originalFileLocation":"features/files.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=\"Upload files of writing samples for fine-tuning\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vaero AI Style API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_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/vaero/JwlOwZFISyxndx1C/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Files - Vaero AI Style API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload files of writing samples for fine-tuning\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vaero AI Style API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vaero.co/features/files\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vaero.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Files\u0026amp;description=Upload+files+of+writing+samples+for+fine-tuning\u0026amp;theme=5c7b8c63a2d91a662fe00b3e\u0026amp;signature=19655c2d07da496011efcf836fb72cfe9f2ad142de4f8ce89384db49ed1f23a7\">\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=\"Files - Vaero AI Style API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload files of writing samples for fine-tuning\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vaero.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Files\u0026amp;description=Upload+files+of+writing+samples+for+fine-tuning\u0026amp;theme=5c7b8c63a2d91a662fe00b3e\u0026amp;signature=19655c2d07da496011efcf836fb72cfe9f2ad142de4f8ce89384db49ed1f23a7\">\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/vaero/JwlOwZFISyxndx1C/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vaero AI Style API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2B4FF3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vaero.co/features/files\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/files.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vaero.co/#organization\",\"name\":\"Vaero AI Style API\",\"url\":\"https://docs.vaero.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vaero/r6BYlJMvZni7Gu_F/logo/vaero_logo.png?fit=max\u0026auto=format\u0026n=r6BYlJMvZni7Gu_F\u0026q=85\u0026s=79a6cbe3dd3f76311eeec327bfe7aafe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vaero.co#website\",\"name\":\"Vaero AI Style API\",\"url\":\"https://docs.vaero.co\",\"publisher\":{\"@id\":\"https://docs.vaero.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vaero.co/features/files#webpage\",\"url\":\"https://docs.vaero.co/features/files\",\"name\":\"Files\",\"description\":\"Upload files of writing samples for fine-tuning\",\"dateModified\":\"2026-04-28T04:51:03.412Z\",\"isPartOf\":{\"@id\":\"https://docs.vaero.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vaero.co/features/files#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vaero.co/features/files#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vaero AI Style API\",\"item\":\"https://docs.vaero.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Files\",\"item\":\"https://docs.vaero.co/features/files\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.vaero.co/features/files#article\",\"headline\":\"Files\",\"name\":\"Files\",\"description\":\"Upload files of writing samples for fine-tuning\",\"url\":\"https://docs.vaero.co/features/files\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vaero.co/features/files#webpage\"},\"dateModified\":\"2026-04-28T04:51:03.412Z\",\"publisher\":{\"@id\":\"https://docs.vaero.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vaero.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vaero AI Style API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vaero AI Style API","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"How to Choose Training Documents","description":"Tips for picking documents for training a style","href":"/choosing-training-documents"}]},{"group":"Features","pages":[{"title":"Files","href":"/features/files"},{"title":"Fine-tuning","description":"Fine-tune a model to write in a style","href":"/features/fine-tuning"},{"title":"Metrics","href":"/features/metrics"},{"title":"Styling","href":"/features/styling"}]},{"group":"Support","pages":[{"title":"Customer Support","href":"/support"},{"title":"Changelog","href":"/changelog"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/files/list-files"}]}]},"title":"Files - Vaero AI Style API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}
