> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.5.2

> File Upload via Public API - Upload files directly to your namespace using the public API endpoint

<Update label="Version 1.5.2" description="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

  <Info>
    **Benefit:** Programmatically upload documents to your namespaces without using the console. Perfect for automation, CI/CD pipelines, and bulk document ingestion workflows.
  </Info>

  #### 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

  ```bash cURL theme={null}
  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.
</Update>