​
2025-06-18
v0.2.0 - Files API Launch

​
Files API (NEW)

We’ve launched a comprehensive new Files API that provides enhanced file management capabilities:

  • 📁 Complete File Management: Upload, list, retrieve, download, and delete files
  • 🔍 Advanced Filtering: Filter files by type, status, and other criteria
  • 📄 Pagination Support: Efficient pagination with configurable page sizes
  • 📱 Original Filename Preservation: Maintains and extracts original filenames
  • ⬇️ Direct Download: Stream file content with proper headers

​
New Endpoints

  • POST /api/v1/files/upload - Upload files with automatic document type detection
  • GET /api/v1/files - List files with filtering and pagination
  • GET /api/v1/files/{file_id} - Get detailed file information
  • GET /api/v1/files/{file_id}/download - Download original file content
  • DELETE /api/v1/files/{file_id} - Delete files permanently

​
🔄 Changes

​
Legacy Upload Endpoint

The original /upload endpoint is now considered legacy but remains fully functional for backward compatibility. We recommend migrating to the new Files API for enhanced features and better file management.

​
🛠️ Improvements

  • Better error handling and validation
  • Improved file metadata tracking
  • Enhanced audit trail capabilities