Storage Overview
Dual storage system with CDN-backed media files and access-controlled document storage.
The PlatformXe Storage Service provides two storage modes designed for different use cases: Media Storage for images and videos with CDN delivery, and Fixed Storage for documents with access control and retention policies.
Storage modes
| Mode | Best for | Features |
|---|---|---|
| Media | Images, videos, thumbnails | Auto-optimization, content moderation, CDN delivery, transformations |
| Fixed | PDFs, contracts, exports | Folder organization, versioning, access levels, retention policies |
Media Storage
Media Storage is optimized for images and videos that need fast delivery to end users. Files are stored on a CDN with automatic optimization and transformation support.
- Auto-optimization -- images are compressed and converted to modern formats (WebP, AVIF) based on the requesting client
- Content moderation -- uploaded images are scanned for policy violations before being made available
- Transformations -- resize, crop, and format conversion via URL parameters
- CDN delivery -- files are served from edge locations for low-latency access worldwide
Fixed Storage
Fixed Storage is designed for documents that need structured organization and access control.
- Folders -- organize files into hierarchical folder structures
- Versioning -- maintain file history with automatic version tracking
- Access levels --
public,authenticated, orprivateper file - Retention policies -- set expiry dates for automatic cleanup
Size limits
| Plan | Max file size | Monthly storage |
|---|---|---|
| Free | 5 MB | 100 MB |
| Basic | 25 MB | 5 GB |
| Pro | 100 MB | 50 GB |
| Enterprise | 500 MB | Custom |
Supported file types
| Category | Formats |
|---|---|
| Images | JPEG, PNG, GIF, WebP, AVIF, SVG, BMP, TIFF |
| Videos | MP4, MOV, AVI, WebM |
| Documents | PDF, DOCX, XLSX, CSV, TXT |
| Archives | ZIP, TAR, GZ |
Executable files (.exe, .sh, .bat, .cmd) are blocked from upload. Archives containing executables are rejected during moderation.
API scopes
| Scope | Access |
|---|---|
storage:upload | Upload and register files |
storage:read | List and retrieve files |
storage:delete | Delete files |
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/storage/media/upload | Direct file upload |
| POST | /api/v1/storage/media/sign-upload | Generate signed upload URL |
| POST | /api/v1/storage/media/register | Register an external URL |
| GET | /api/v1/storage/media/files | List files |
| GET | /api/v1/storage/media/files/:fileId | Get a single file |
| DELETE | /api/v1/storage/media/files/:fileId | Delete a file |
| POST | /api/v1/storage/media/files/reorder | Reorder files |
Next steps
- Upload Files -- upload, signed upload, and external URL registration
- Manage Files -- list, retrieve, delete, and reorder files