Back to API
API Documentation

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/v1

Key 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.

PlanRequests/minMax ImageMax FileStorage
Free305 MB10 MB1 GB
Starter6010 MB50 MB10 GB
Pro12025 MB100 MB100 GB
Enterprise50050 MB500 MB1 TB

API Endpoints Summary

POST/api/v1/filesUpload file
GET/api/v1/files/:idDownload file
POST/api/v1/imagesUpload image
GET/api/v1/images/:idGet image
POST/api/v1/swappable-imagesCreate swappable
POST/api/v1/urlsCreate short URL

Ready to Start?

Get your API key and start uploading in minutes.

Get API Key