Skip to main content
​
Version 1.5.2
Released November 25, 2025

​
New Features

​
Upload Files via Public API

  • Direct file upload - Upload files directly to your namespace using the public API endpoint
  • Multiple file formats supported - PDF, DOCX, XLSX, JSON, TXT, CSV, and Markdown files
  • Multipart form data - Simple file upload using standard multipart/form-data encoding
  • Automatic processing - Files are automatically queued for ingestion and indexing
Benefit: Programmatically upload documents to your namespaces without using the console. Perfect for automation, CI/CD pipelines, and bulk document ingestion workflows.

​
Supported File Types

ExtensionDescription
.pdfPDF documents
.docxMicrosoft Word documents
.xlsxMicrosoft Excel spreadsheets
.jsonJSON files
.txtPlain text files
.csvCSV files
.mdMarkdown files

​
Quick Start Example

cURL
curl -X POST "https://api.moorcheh.ai/v1/namespaces/{namespace-name}/upload-file" \
  -H "x-api-Key: YOUR_API_KEY" \
  -F "file=@path/to/your/document.pdf"

​
Important Notes

​
Processing Time

After uploading a file, it will be queued for ingestion. The file needs to be processed and indexed before it becomes searchable. To verify ingestion status, use the List Namespaces endpoint and check the total_items count before and after upload.

​
File Size Limit

Maximum file size is 10MB per upload. For larger files, consider splitting them into smaller documents or using the Upload Text Data endpoint for preprocessed content.

​
Text Namespace Required

File uploads are only supported for text-type namespaces. Vector namespaces cannot accept file uploads directly.