Introduction

A folder is a virtual container that lets you logically group files inside a namespace.
Unlike files, folders do not store data directly — they exist to help you organize and navigate large sets of files using familiar paths and structures.

Trelae doesn’t enforce physical directories in storage. Instead, folders are represented through a file’s location path.
For example, a file stored at project/reports/summary.pdf appears under a project/reports folder when you query or browse your namespace.

You can create folders explicitly using the API or SDK to make it easier to prepare structured paths before uploading files.
This is helpful for organizing content, applying location-based filters, and managing files at scale.

Unlike files, folders:

• Do not have file contents or binary data
• Do not support download URLs
• Can be listed and created through the same APIs used for managing files

Every folder must belong to a specific namespace, just like files.
This ensures your virtual folder structure stays organized within your project’s access and region boundaries.

Use folders to build clear, maintainable storage layouts — from simple images or backups to deeply nested structures like projects/client-x/reports/2024.