Workato · Agent Studio headless API
File too large (headless API file upload)
Short answer
The headless API rejects a file upload as "File too large" when the file is over the 20 MB maximum. Upload a single file of 20 MB or less as multipart/form-data.
VerifiedLast verified
01Error text
File too large02Likely causes
- The file is larger than the maximum size of 20 MB.
- Uploads accept a single file per request.
03How to fix it
- Reduce the file to 20 MB or less.
- Send
multipart/form-datawith a single file field, and do not setContent-Typemanually. - Pass the returned
file_idin the Send a message call.
04Official documentation
→Related errors
- 401 auth_failed (headless API)A 401 with error_code auth_failed from the headless API means the token in the request was not accepted. Check, in this order, the token type, the data center host, whether the key was rotated, and the Authorization header format.
- 400 Bad RequestA 400 Bad Request error in Workato means the external server could not process the request because it is malformed or invalid. Check field names, required values, record IDs and file sizes in the failing step, then reconnect the app.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer