# PAYLOAD_TOO_LARGE

Too much data in one call.

- **HTTP class:** 413
- **Retryable:** no

## What happened

The files in one call decode to more than 4 MiB.

## Fix

Spread the files over several calls with `finalize=false`, keep the returned `deploy_id`, and publish with `finalize=true`. A single large file goes in pieces (`part`, `parts`). On Muse keep each call's arguments under about 90 KB.

## What to tell the user

Nothing.

## Agent hint

The exact `error.hint` text; Carnival fills each `<…>` for the call.

```text
Too much data in one call. Send at most 4 MB per call (about 90 KB on Muse) using finalize=false and deploy_id.
```

## Related

- [`TOO_MANY_FILES_IN_CALL`](https://carnival-staging.dev/docs/errors/TOO_MANY_FILES_IN_CALL.md): Too many files in one call.
- [`FILE_TOO_LARGE`](https://carnival-staging.dev/docs/errors/FILE_TOO_LARGE.md): A file is too large.
- [`MISSING_PARTS`](https://carnival-staging.dev/docs/errors/MISSING_PARTS.md): Some pieces are missing.

All error codes: [error codes](https://carnival-staging.dev/docs/errors.md)