Rabbinatix
Sign inGet started
Store

Upload a file

FreeFlow
@rabbinatix/upload-a-file by Rabbinatixupdated Oct 13, 2026

The app asks for a signed upload link; files that are too big or of the wrong type are refused before anything is stored.

Sign up to use it

Uploading a photo, a document or an attachment the way it scales:

  • Client app asks for an upload link with the file’s name, type and size, then sends the file straight to that link.
  • Files service refuses a file that is too big (413) or of a type it doesn’t take (415), records the file as uploading, and asks the storage for a short-lived signed link.
  • Files database keeps a record of every file. Object storage (S3, Cloud Storage, Azure Blob) holds the files and signs the links.

Tricky step: the file never passes through your servers: the signed link lets the browser put exactly this one file in storage, for a few minutes. Check the size and type before signing, and again when the upload lands.

Previewlanes are roles; you pick your systems when importing
400Other
Start in Client app. step 1 of 15. key stepOn Upload a file
Call to another system in Client app. step 2 of 15. key stepCall ask for upload link
Start in Files service. step 3 of 15. key stepOn POST /api/v1/uploads
Return in Files service. step 4 of 15. key stepToo big → 413
Resource in Files service. step 5 of 15. key stepRecord the file
Answer in Files database. step 6 of 15. key stepfiles.insert
Resource in Files service. step 7 of 15. key stepGet a signed upload link
Answer in Object storage. step 8 of 15. key stepstorage.signUploadUrl
Return in Files service. step 9 of 15. key stepLink ready → 201
Return in Files service. step 10 of 15. key stepStorage down → 503
Return in Files service. step 11 of 15. key stepWrong type → 415
Return in Files service. step 12 of 15. key stepNo name → 400
Return in Client app. step 13 of 15. key stepReturn
Return in Client app. step 14 of 15. key stepReturn
Return in Client app. step 15 of 15. key stepReturn
Client app
Web frontend
Files service
Backend service
Files database
Database
Object storage
External API

Up and down arrows: previous or next step. Home, End: first or last. Enter: select. Shift F10: more actions.

APIs
POST{base}/uploads· Ask for an upload link
Files service provides it · Client app calls it
Request body
fileName: string
contentType: string
size: integer
201
fileId: string
uploadUrl: string
400
error: string
413
error: string
415
error: string
503
error: string
Data operations
files.insertinserton Files database(fileName: string, contentType: string, size: integer, status: string)
storage.signUploadUrlcallon Object storage(key: string, contentType: string)
Test cases
Photo gets an upload link→ Link ready
File too big→ Too big
Type not allowed→ Type not allowed
No file name→ No name
Storage doesn’t answer→ Try again later
Requirements
Files bigger than the limit are refused before a link is made.
Only the allowed types of file can be uploaded.
Files go straight to storage with a signed link; the service only records them.
Roles (4)
Client app
Where people pick a file · Web frontend or mobile app
Files service
Checks the file and hands out upload links · Backend service
Files database
A record of every file · Database
Object storage
Holds the files and signs upload links · External API
Settings
Largest file (MB)10
Types allowedimage/jpeg,image/png,image/webp,application/pdf
File name fieldfileName (renamable)
Versions