v1.5.2 - Moorcheh Documentation

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

Extension	Description
`.pdf`	PDF documents
`.docx`	Microsoft Word documents
`.xlsx`	Microsoft Excel spreadsheets
`.json`	JSON files
`.txt`	Plain text files
`.csv`	CSV files
`.md`	Markdown 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.

​New Features

​Upload Files via Public API

​Supported File Types

​Quick Start Example

​Important Notes

​Processing Time

​File Size Limit

​Text Namespace Required

New Features

Upload Files via Public API

Supported File Types

Quick Start Example

Important Notes

Processing Time

File Size Limit

Text Namespace Required