{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"Orchata","colors":{"primary":"#FA8565","light":"#FA8565","dark":"#FA8565"},"logo":{"light":"https://cdn.orchata.ai/img/orchata-logo-light.svg","dark":"https://cdn.orchata.ai/img/orchata-logo-dark.svg"},"favicon":"/favicon.ico","background":{"decoration":"grid","color":{"light":"#FDF5DF","dark":"#1C1827"}},"navbar":{"links":[{"href":"mailto:support@orchata.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.orchata.ai"}},"footer":{"socials":{"github":"https://github.com/orchata-ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Back to Site","icon":"home","href":"https://orchata.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"orchatalabs","hasAudioNarration":false,"actualSubdomain":"orchatalabs","customDomains":["orchata.ai"],"gitSource":{"type":"github","owner":"orchata-ai","repo":"orchata-rag","deployBranch":"develop","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae940c687cae518f465a8c7:success","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Endpoints","count":21},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Documents","count":10},{"language":"default","tag":"Spaces","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"AI Tool Setup","count":4},{"language":"default","tag":"TypeScript SDK","count":4},{"language":"default","tag":"MCP Server","count":3},{"language":"default","tag":"Admin","count":3}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/documents/upload-document","slug":"/api-reference/documents/upload-document","pageMetadata":{"title":"Upload Document","description":"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/documents","href":"/api-reference/documents/upload-document","autogeneratedByOpenApi":true,"hidden":false},"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 a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\"\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 Document","description":"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/documents","href":"/api-reference/documents/upload-document","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Documents"],"summary":"Upload Document","description":"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).","x-codeSamples":[{"lang":"typescript","label":"TypeScript SDK (Content)","source":"import { Orchata } from '@orchata-ai/sdk';\n\nconst client = new Orchata({ apiKey: 'oai_your_api_key' });\n\n// Upload raw content\nconst { document } = await client.documents.upload({\n spaceId: 'space_123',\n content: '# My Document\\n\\nSome markdown content...',\n filename: 'my-doc.md',\n metadata: { category: 'guides' }\n});"},{"lang":"typescript","label":"TypeScript SDK (File)","source":"import { Orchata } from '@orchata-ai/sdk';\n\nconst client = new Orchata({ apiKey: 'oai_your_api_key' });\n\n// Upload a file (browser)\nconst { document } = await client.documents.uploadFile({\n spaceId: 'space_123',\n file: fileInput.files[0]\n});"}],"requestBody":"67e20f88-573e-4adb-b4ce-e2ea67ef3615","responses":{"201":"1f2fbc5a-6c85-4c39-8dc3-9b4ba791a5dc","401":"9dbe3f9a-b573-445d-ad21-6ab7b5cea769","403":"eb42ab0b-014c-4e92-95cd-245dc2e2c1fb","404":"9304c6b2-a7cb-4a69-98f5-5f1015e7eec0"},"method":"post","type":"path","servers":["27616fde-a7f5-4ae5-a362-1fb86892a734"],"security":["c7c83795-2758-4207-b371-e5b1dceae23c"],"path":"/api/documents","baseUrlOptions":["https://api.orchata.ai"],"title":"Upload Document","codeSamples":[{"label":"TypeScript SDK (Content)","lang":"typescript","source":"import { Orchata } from '@orchata-ai/sdk';\n\nconst client = new Orchata({ apiKey: 'oai_your_api_key' });\n\n// Upload raw content\nconst { document } = await client.documents.upload({\n spaceId: 'space_123',\n content: '# My Document\\n\\nSome markdown content...',\n filename: 'my-doc.md',\n metadata: { category: 'guides' }\n});"},{"label":"TypeScript SDK (File)","lang":"typescript","source":"import { Orchata } from '@orchata-ai/sdk';\n\nconst client = new Orchata({ apiKey: 'oai_your_api_key' });\n\n// Upload a file (browser)\nconst { document } = await client.documents.uploadFile({\n spaceId: 'space_123',\n file: fileInput.files[0]\n});"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"spaceId":{"type":"string","description":"The ID of the space to upload the document to","example":"space_123","isRequired":true,"uniqueKey":"spaceId","typeLabel":"string"},"file":{"type":"string","format":"binary","description":"The file to upload","uniqueKey":"file","typeLabel":"file"},"filename":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"filename","typeLabel":"string"},"embeddingModel":{"type":"string","uniqueKey":"embeddingModel","typeLabel":"string"},"metadata":{"type":"string","uniqueKey":"metadata","typeLabel":"string"}},"required":["spaceId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"spaceId":"space_123","file":"\u003cstring>","filename":"\u003cstring>","embeddingModel":"\u003cstring>","metadata":"\u003cstring>"}}},"exampleType":"generated"},"application/json":{"schema":{"type":"object","properties":{"spaceId":{"type":"string","description":"The ID of the space to upload the document to","example":"space_123","isRequired":true,"uniqueKey":"spaceId","typeLabel":"string"},"content":{"type":"string","minLength":1,"description":"The raw markdown or text content to upload","example":"# My Document\n\nSome markdown content...","isRequired":true,"uniqueKey":"content","typeLabel":"string"},"filename":{"type":"string","minLength":1,"maxLength":255,"description":"Optional filename for the document (defaults to 'document.md')","example":"my-document.md","uniqueKey":"filename","typeLabel":"string"},"embeddingModel":{"type":"string","description":"The embedding model to use for this document","uniqueKey":"embeddingModel","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"metadata.additionalProperties","typeLabel":"any"},"description":"Optional metadata to attach to the document","uniqueKey":"metadata","typeLabel":"object"}},"required":["spaceId","content"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"spaceId":"space_123","content":"# My Document\n\nSome markdown content...","filename":"my-document.md","embeddingModel":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1f2fbc5a-6c85-4c39-8dc3-9b4ba791a5dc":{"description":"Document uploaded successfully","content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"document.id","typeLabel":"string"},"orgId":{"type":"string","isRequired":true,"uniqueKey":"document.orgId","typeLabel":"string"},"spaceId":{"type":"string","isRequired":true,"uniqueKey":"document.spaceId","typeLabel":"string"},"filename":{"type":"string","isRequired":true,"uniqueKey":"document.filename","typeLabel":"string"},"mimeType":{"type":"string","isRequired":true,"uniqueKey":"document.mimeType","typeLabel":"string"},"fileSize":{"type":"string","isRequired":true,"uniqueKey":"document.fileSize","typeLabel":"string"},"storageUrl":{"type":"string","isRequired":true,"uniqueKey":"document.storageUrl","typeLabel":"string"},"status":{"type":"string","isRequired":true,"uniqueKey":"document.status","typeLabel":"string"},"errorMessage":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.errorMessage.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.errorMessage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.errorMessage","typeLabel":"string | null"},"embeddingModel":{"type":"string","isRequired":true,"uniqueKey":"document.embeddingModel","typeLabel":"string"},"indexingType":{"type":"string","isRequired":true,"uniqueKey":"document.indexingType","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"document.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"document.updatedAt","typeLabel":"string\u003cdate-time>"},"metadata":{"oneOf":[{}],"uniqueKey":"document.metadata","typeLabel":"any"}},"required":["id","orgId","spaceId","filename","mimeType","fileSize","storageUrl","status","errorMessage","embeddingModel","indexingType","createdAt","updatedAt"],"isRequired":true,"uniqueKey":"document","typeLabel":"object"}},"required":["document"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"document":{"id":"\u003cstring>","orgId":"\u003cstring>","spaceId":"\u003cstring>","filename":"\u003cstring>","mimeType":"\u003cstring>","fileSize":"\u003cstring>","storageUrl":"\u003cstring>","status":"\u003cstring>","errorMessage":"\u003cstring>","embeddingModel":"\u003cstring>","indexingType":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","metadata":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9dbe3f9a-b573-445d-ad21-6ab7b5cea769":{"description":"Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"eb42ab0b-014c-4e92-95cd-245dc2e2c1fb":{"description":"Insufficient permissions","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"9304c6b2-a7cb-4a69-98f5-5f1015e7eec0":{"description":"Space not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"c7c83795-2758-4207-b371-e5b1dceae23c":{"ApiKey":{"type":"apiKey","in":"header","name":"Oai-Api-Key","scopes":[]}}},"servers":{"27616fde-a7f5-4ae5-a362-1fb86892a734":{"url":"https://api.orchata.ai","description":"Orchata API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Oai-Api-Key","scopes":[]},"schema":{"title":"Oai-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"Oai-Api-Key"}],"title":"ApiKey"}]},"originalFileLocation":"api/openapi.json"},"subdomain":"orchatalabs","siteName":"Orchata","title":"Upload Document - Orchata","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-10T14:43:26.097Z","originalFileLocation":"api-reference/documents/upload-document.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 a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Orchata\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_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=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload Document - Orchata\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Orchata\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://orchata.ai/docs/api-reference/documents/upload-document\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://orchatalabs.mintlify.site/docs/_mintlify/api/og/v2?division=Documents\u0026amp;title=Upload+Document\u0026amp;description=Upload+a+new+document+to+a+space.+Supports+both+file+uploads+%28multipart%2Fform-data%29+and+raw+markdown%2Ftext+content+%28application%2Fjson%29.\u0026amp;theme=733c0f40f2f162a3cf9276b1\u0026amp;signature=e6942f53528e91866af05269e0eb11a71f28a514120df59b94fb9bcd7576e772\">\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 Document - Orchata\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://orchatalabs.mintlify.site/docs/_mintlify/api/og/v2?division=Documents\u0026amp;title=Upload+Document\u0026amp;description=Upload+a+new+document+to+a+space.+Supports+both+file+uploads+%28multipart%2Fform-data%29+and+raw+markdown%2Ftext+content+%28application%2Fjson%29.\u0026amp;theme=733c0f40f2f162a3cf9276b1\u0026amp;signature=e6942f53528e91866af05269e0eb11a71f28a514120df59b94fb9bcd7576e772\">\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=\"/docs/mintlify-assets/_mintlify/favicons/orchatalabs/UANI6yfg0lJWC1cq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Orchata\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FA8565\">\u003clink data-mint-head rel=\"canonical\" href=\"https://orchata.ai/docs/api-reference/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/documents/upload-document.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://orchata.ai/#organization\",\"name\":\"Orchata\",\"url\":\"https://orchata.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.orchata.ai/img/orchata-logo-light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://orchata.ai/docs#website\",\"name\":\"Orchata\",\"url\":\"https://orchata.ai/docs\",\"publisher\":{\"@id\":\"https://orchata.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://orchata.ai/docs/api-reference/documents/upload-document#webpage\",\"url\":\"https://orchata.ai/docs/api-reference/documents/upload-document\",\"name\":\"Upload Document\",\"description\":\"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\",\"dateModified\":\"2026-02-10T14:43:26.097Z\",\"isPartOf\":{\"@id\":\"https://orchata.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://orchata.ai/docs/api-reference/documents/upload-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://orchata.ai/docs/api-reference/documents/upload-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://orchata.ai/docs/api-reference/admin/get-platform-analytics\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documents\",\"item\":\"https://orchata.ai/docs/api-reference/documents/list-documents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Upload Document\",\"item\":\"https://orchata.ai/docs/api-reference/documents/upload-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://orchata.ai/docs/api-reference/documents/upload-document#apireference\",\"headline\":\"Upload Document\",\"name\":\"Upload Document\",\"description\":\"Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).\",\"url\":\"https://orchata.ai/docs/api-reference/documents/upload-document\",\"mainEntityOfPage\":{\"@id\":\"https://orchata.ai/docs/api-reference/documents/upload-document#webpage\"},\"dateModified\":\"2026-02-10T14:43:26.097Z\",\"publisher\":{\"@id\":\"https://orchata.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://orchata.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Orchata\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Orchata\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/documents/upload-document.md","siteName":"Orchata","nav":{"global":{"anchors":[{"anchor":"Back to Site","icon":"home","href":"https://orchata.ai"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction","hidden":false}]},{"group":"Endpoints","pages":[{"group":"Admin","pages":[{"title":"Get Platform Analytics","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/admin/analytics","href":"/api-reference/admin/get-platform-analytics"},{"title":"Get Documents Over Time","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/admin/analytics/documents","href":"/api-reference/admin/get-documents-over-time"},{"title":"Get Users Over Time","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/admin/analytics/users","href":"/api-reference/admin/get-users-over-time"}]},{"group":"Spaces","pages":[{"title":"List Spaces","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/spaces","href":"/api-reference/spaces/list-spaces"},{"title":"Create Space","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/spaces","href":"/api-reference/spaces/create-space"},{"title":"Get Space","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/spaces/{id}","href":"/api-reference/spaces/get-space"},{"title":"Delete Space","deprecated":null,"version":null,"openapi":"api/openapi.json delete /api/spaces/{id}","href":"/api-reference/spaces/delete-space"},{"title":"Update Space","deprecated":null,"version":null,"openapi":"api/openapi.json patch /api/spaces/{id}","href":"/api-reference/spaces/update-space"},{"title":"Get Space Limits","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/spaces/{id}/limits","href":"/api-reference/spaces/get-space-limits"}]},{"group":"Documents","pages":[{"title":"List Documents","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/documents","href":"/api-reference/documents/list-documents"},{"title":"Upsert Document","description":"Create or update a document by filename. If a document with the given filename exists in the space, updates it. Otherwise creates a new document. Embeddings are generated synchronously - the document is immediately queryable.","deprecated":null,"version":null,"openapi":"api/openapi.json put /api/documents","href":"/api-reference/documents/upsert-document"},{"title":"Upload Document","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/documents","href":"/api-reference/documents/upload-document"},{"title":"Batch Upload Documents","description":"Upload multiple documents to a space in a single request. Each document is processed independently. Maximum 100 documents per request.","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/documents/batch","href":"/api-reference/documents/batch-upload-documents"},{"title":"Get Document by Filename","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/documents/by-filename","href":"/api-reference/documents/get-document-by-filename"},{"title":"Get Document","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/documents/{id}","href":"/api-reference/documents/get-document"},{"title":"Delete Document","deprecated":null,"version":null,"openapi":"api/openapi.json delete /api/documents/{id}","href":"/api-reference/documents/delete-document"},{"title":"Update Document","deprecated":null,"version":null,"openapi":"api/openapi.json patch /api/documents/{id}","href":"/api-reference/documents/update-document"},{"title":"Get Processed Document Content","deprecated":null,"version":null,"openapi":"api/openapi.json get /api/documents/{id}/content","href":"/api-reference/documents/get-processed-document-content"},{"title":"Append to Document","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/documents/{id}/append","href":"/api-reference/documents/append-to-document"}]},{"group":"Queries","pages":[{"title":"Query Spaces","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/query","href":"/api-reference/queries/query-spaces"},{"title":"Smart Query - Discover Relevant Spaces","deprecated":null,"version":null,"openapi":"api/openapi.json post /api/query/smart","href":"/api-reference/queries/smart-query--discover-relevant-spaces"}]}]}]}]},"basePath":"","title":"Upload Document - Orchata","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}