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

Workato error
File too large

02Likely causes

  • The file is larger than the maximum size of 20 MB.
  • Uploads accept a single file per request.

03How to fix it

  1. Reduce the file to 20 MB or less.
  2. Send multipart/form-data with a single file field, and do not set Content-Type manually.
  3. Pass the returned file_id in the Send a message call.

04Official documentation

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

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.