Files
Uploading, downloading, replacing and versioning files: where the bytes live, where the metadata lives, and how both stay together.
Topics in this subject area
- 1.What a file model is
Metadata in the database, content in the file storage. This page explains who manages which part.
- 2.Uploading
The two ways multipart and Base64, the matching endpoints, and how file part and file object find each other by name.
- 3.Downloading
How
GET /{id}/fileworks, why the token is in the URL here, and which permissions and limits apply. - 4.Replacing and renaming
What an update with and without a new file does: replace the content, only rename, or both.
- 5.File versions
For audited file models every old state is kept. How the versions are stored, how revision and content belong together, and when content is simply overwritten.
- 6.Storage layout and tenant isolation in storage
How the storage path is built, how tenants are separated in the file system, and how a file is stored atomically.
- 7.Size limits
Which size limits apply to uploads and downloads, what happens when one is exceeded, and where to configure them.
- 8.Storage backends
Where the file contents live: local file system or volume, and applications without any file storage.