File Upload Strategies
Compare the two upload mechanisms supported by Actyx RPC: standard Multipart/Form-Data and memory-efficient Binary Streaming.
Multipart/Form-Data Mode
Packs file and text metadata (description) into standard Form-Data. Buffers the request in memory.
Which should you choose?
Multipart Mode
Ideal when submitting small to medium files accompanied by structured form fields (e.g. description, category, tags).
mutate({ file, desc })Binary Streaming
Best for uploading large files (50MB+). Streams the file raw in the request body, bypassing parsing boundaries entirely to save server CPU/RAM.
mutate(file)Real-time progress reporting works natively in both modes using progress XHR listeners. Under the hood, Actyx RPC manages browser transport and formats content headers automatically.