file_too_large

HTTP 413 · code: "file_too_large" · type: https://docs.formfeed.dev/errors/file-too-large

The uploaded file is larger than the limit for where it goes. bytes is the size of the file, limit the limit that applied, both in bytes. Nothing was stored or charged.

Upload	Limit
A file for the workspace's file library (POST /v1/files)	10 MB
An office document sent to /pdf/convert	20 MB
The file of a Word or PowerPoint template	20 MB
A logo of the brand kit, in the app	512 kB

Example

{
  "type": "https://docs.formfeed.dev/errors/file-too-large",
  "title": "File too large",
  "status": 413,
  "detail": "The file is 12480 kB; the limit is 10 MB",
  "code": "file_too_large",
  "bytes": 12779520,
  "limit": 10485760,
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Common causes

• A photo straight from a camera, or a logo exported as a print-resolution PNG.
• A scanned PDF you meant to merge; scans of many pages grow quickly.
• An office document above 20 MB, usually because of large pictures in it.

How to fix it

• Scale the image to the size the document shows it at. A logo 400 px wide is enough for print at the sizes templates use it.
• Compress: WebP or a JPEG at quality 80 is usually a fraction of the PNG.
• For a large PDF you only want to merge, split it and merge the parts, or keep it outside the library and render it in pieces.
• For an office document, compress its pictures before converting (in Word: File › Compress Pictures).

Retry?

No. The same file gives the same answer. Make the file smaller, then send the request again with a new Idempotency-Key or without one: a 4xx answer is stored under its key for 24 hours, so the old key returns this problem again. See retrying.