Introduction

A file is the fundamental object you will store, manage, and deliver through your project. The platform supports all file types and sizes up to 5 TB, giving you the flexibility to handle everything from small text assets to massive videos and datasets.

There is no strict concept of folders or directories — instead, files are organized using a location path. By default, every file is stored at the root (/) location. However, you can simulate folder structures by assigning a custom location when uploading files. For example, you can store files under paths like images, backups, or project/reports.

When you query or manage files later, you can use the location to filter, organize, or group related files together. This keeps your storage tidy and makes it easy to work with large collections of files.

Every file must belong to a specific namespace, which acts as the container that controls storage region, access level, and isolation. This ensures your files are organized under the right structure and security settings.

Files can be uploaded, retrieved, moved, copied, deleted, or manipulated through the dashboard UI or fully programmatically using the API or SDK — giving you full control over your storage workflows.