API Overview
The Foldr.Space API provides a simple, unified backend for file hosting, image hosting, and URL shortening. Built for developers who want reliable media hosting without complexity.
Base URL
https://foldr.space/api/v1Key Features
File Hosting
Upload any file type with optional permanent storage. Get shareable links instantly.
Image Hosting
Optimized image uploads with permanent CDN-delivered URLs and automatic format detection.
Swappable Images
Dynamic images that update via API while keeping the same URL. Perfect for OBS overlays.
URL Shortener
Create branded short links with custom slugs and click analytics.
Rate Limits & File Sizes
Limits vary by plan. All responses include rate limit headers.
| Plan | Requests/min | Max Image | Max File | Storage |
|---|---|---|---|---|
| Free | 30 | 5 MB | 10 MB | 1 GB |
| Starter | 60 | 10 MB | 50 MB | 10 GB |
| Pro | 120 | 25 MB | 100 MB | 100 GB |
| Enterprise | 500 | 50 MB | 500 MB | 1 TB |
API Endpoints Summary
POST
/api/v1/filesUpload fileGET
/api/v1/files/:idDownload filePOST
/api/v1/imagesUpload imageGET
/api/v1/images/:idGet imagePOST
/api/v1/swappable-imagesCreate swappablePOST
/api/v1/urlsCreate short URL