Skip to main content

FilesHub Docs

Zero-cost file storage + utility API for every app. Upload, store, and serve files over a simple HTTP API keyed by X-API-Key.

Upload over plain HTTP

POST a multipart file to /api/v1/objects with your X-API-Key and get back a stable public URL plus a ULID. No SDK to install — curl, fetch, axios, or any HTTP client works.

Per-file visibility

Mark each upload public or private. Public objects are served to anyone at their URL; private objects require a read-permission API key from the same project to download.

List, download, delete

Page through your project’s objects, stream any file back by its ULID, and permanently delete an object (the stored file is removed with it). Four endpoints cover the whole lifecycle.

Optional auto-expiry

Set expires_in_days or an absolute expires_at on upload and FilesHub treats the object as gone once it expires — a self-cleaning slot for temporary files like one-time exports or share links.

Scoped, restrictable API keys

Keys are per project with read / write permissions and optional origin / app-id restrictions, so a browser key can be locked to your domain and a mobile key to your bundle id.

50+ utility endpoints

Beyond storage, FilesHub exposes hashing, encoding, converters, QR codes, short URLs, OTP, an encryption vault, image/PDF processing, and more — the same key, one base URL.

Built and maintained by Ahsan Mahmood LinkedIn · GitHub · npm