Introduction
APULODI is file infrastructure for developers. Upload files, organize them into folders, version their content, attach custom metadata, and hand your users short-lived download URLs — without running your own storage.
APULODI is a complete file platform: one API for everything — upload, organization, versioning, metadata, and delivery.
Two interfaces, one platform
- The developer API (
/v1/*) — every capability is exposed as a predictable HTTP endpoint, authenticated with your project's API key. @apulodi/sdk— the official TypeScript client. Same platform, same guarantees, but with a promise-based API, full autocompletion, and typed responses.
Use whichever fits your stack; both give you the same feature set.
What you can do today
- Upload files — bytes flow straight from your server to APULODI's storage. APULODI handles scaling, durability, and delivery.
- Folders — organize files into logical paths like
users/avatars. Folders are a first-class APULODI concept; you never manage storage layout directly. - Versioning — replace a file's content without losing the previous version.
- Custom metadata — attach arbitrary key/value data to every file.
- Multipart uploads — resumable, session-based uploads for large files.
- Server-side copy — copy files between folders without moving bytes through your network.
- Search & filter — name search, path/status/content-type filters and cursor pagination.
Concepts
| Concept | What it is |
|---|---|
| Organization | The top-level account that owns projects and billing. |
| Project | A workspace with its own files, folders and API keys. Isolated from every other project. |
| API key | A secret credential scoped to one project. All /v1/* requests authenticate with it. |
| File | A stored object plus metadata: filename, contentType, size, status, version, metadata. |
| Folder | A node in the logical path tree (users/avatars). Auto-created by path-aware uploads. |
| Upload session | A multipart upload in progress. Identified by a client-safe upload_... id. |
Ready to try it? Head to the Quickstart — you'll be uploading your first file in a few minutes.