Bucket Files

File upload/download/trash lifecycle within a bucket

📄️Start a file upload

Requires contributor role or above on this bucket. Creates a `File` record in `uploading` status and returns a presigned POST policy for the client to upload directly to storage. For providers without bucket-notification support, the client must confirm completion via `PATCH .../files/{fileId}` with `status: uploaded`.

📄️Transition a file's status (confirm upload, trash, or restore)

Requires contributor role or above on this bucket. `status: 'uploaded'` confirms a pending upload, or restores the file if it was trashed. `status: 'deleted'` moves the file to trash.

📄️Permanently delete a trashed file

Requires contributor role or above on this bucket. The file must already be in trash; this removes it from storage and the database.

📄️Get a presigned download URL for a file

Requires viewer role or above on this bucket.